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| About GDDM 


Reference (SC41-3718) 


This book is a reference book for programmers to be used with the book GDDM 
Programming, SC41-3717. These books describe the application program interface 
(API) with the graphics capabilities of the Operating System/400 (OS/400) program. 
Included are detailed descriptions of all the graphics routines available in graphical 
data display manager (GDDM) and information about high-level language interfaces 
with GDDM. 


This book does not describe how to use the IBM AS/400 Business Graphics Utility 
(BGU), nor does it describe an interface with BGU. For information on BGU, refer 
to the book BGU User's Guide and Reference, SC09-1408. You may need to refer 
to other IBM books for more specific information about a particular topic. The book 
Publications Ordering, SC41-3000, provides information on all the books in the 
AS/400 library. 


For a list of related publications, see the “Bibliography.” 


| Who Should Use This Book 
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This book is to be used by AS/400 application programmers responsible for 
creating graphics applications. Programmers who have used GDDM or 
GDDM-presentation graphics feature (GDDM-PGF) on the IBM System/370 
computer can use this book to familiarize themselves with differences between the 
System/370 and the AS/400 systems. 


To use this book, you should understand the concepts of the IBM Operating 
System/400 licensed program and the AS/400 system. 


You should know how to write, debug, compile, and run programs in one of the 
following programming languages supported by the AS/400 system: BASIC, 
COBOL/400, Pascal, PL/I, or RPG/400 language. 


Throughout this book, the term persona! computer applies to any IBM personal 


computer that uses work station function (WSF), work station emulation (WSE), or 
5250 emulation. 
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Overview of OS/400 Graphics 
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Operating System/400* (OS/400*) Graphics includes both Graphical Data Display 
Manager (GDDM*) and Presentation Graphics routines. GDDM is a means of 
displaying, printing, or plotting pictures. Presentation Graphics routines are a 
means of displaying, printing, or plotting business charts. 


You can write and run OS/400 Graphics application programs using any model of 
the AS/400* system (it must have the OS/400 program installed). 


Although you can write and compile the programs on any work station that has 
been described to the system, only the following devices can be used to display 
graphics: 


¢ IBM* personal computer with work station function (WSF) 

¢ IBM personal computer with work station emulation (WSE) 

e IBM Personal System/55 with DBCS 5250 graphic emulation 
¢ 5292 Model 2 

e IBM personal computer with 5250 emulation 


In this book the term “graphics work station” means one of these devices. 


These plotters can be attached to graphics work stations: 


e IBM 6180 Plotter 
e IBM 6182 Plotter 
e IBM 6184 Plotter 
e IBM 6185 Plotter 
e IBM 6186-1 Plotter 
e IBM 6186-2 Plotter 
e IBM 7371 Plotter 
e¢ IBM 7372 Plotter 


Graphics can be printed on these SNA character string (SCS) devices: 


e IBM 4214 Printer 
e IBM 4234-2 Printer 
e IBM 5224 Printer 
e IBM 5225 Printer 


You can also use any intelligent printer data stream* (IPDS*) device that supports 
graphics, including: 


e IBM 3812 Printer 
e IBM 3816 Printer 
e IBM 4028 Printer 
e IBM 4224 Printer 


It is also possible to send a graphics data format (GDF) file (the internal data 
GDDM interprets to draw the picture) to other systems. The device receiving the 
graphics data must have the software necessary to interpret the data. 
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To use OS/400 Graphics, you code CALL statements in application programs 
written in a high-level language. The parameters you pass with the call determine 
what OS/400 Graphics does. You must specify parameters of the correct data type 
to be used with graphics. For specific information, see “High-Level Languages.” 


The data you display graphically can come from any source normally available to 
your programs: 


e Database files on your system 

e Input from interactive display stations 

¢ Communications lines connecting your system with other systems 
¢ Device files (such as diskette files or tape files) 

e Data coded directly in your programs 


System Requirements for Using GDDM and Presentation Graphics 
Routines 


¢ GDDM and Presentation Graphics routines are part of OS/400 Graphics. The 
IBM-supplied library QGDDM must be installed on your system for you to use 
OS/400 Graphics in Pascal or PL/I and for you to use graphics symbol sets in 
any language. To install library QGDDM, refer to the Software Installation 
book. 


¢ You cannot call GDDM or Presentation Graphics routines directly from the work 
station (for example, from the command entry display). You must code 
graphics calls in a high-level language (BASIC, the COBOL/400* language, 
Pascal, PL/I, or the RPG/400* language), then run the program. 


e When you are using Pascal, PL/I, or graphics symbol sets, library QGDDM 
must be in your library list or in the library list named in the job description of a 
batch job used to compile or run graphics programs. 


High-Level Languages 


On the AS/400 system you use GDDM and Presentation Graphics routines by 
calling (CALL statement) graphics routines from your programs. The parameters 
that you pass with the calls must be of specific data types. 


OS/400 Graphics uses the following data types: 


e Four-byte binary integers 

e Floating-point numbers 

e Character strings 

e Arrays of the above data types 


If the data types of the parameters passed by your program do not match those 
required by OS/400 Graphics, undesired results, possibly a function check, can 
occur. 


The following sections describe how to code the calls and data types for these 
high-level languages: 


e IBM AS/400 BASIC 

e IBM SAA* AD/Cycle* COBOL/400 programming language 
e IBM AS/400 Pascal 

e¢ IBM AS/400 PL/I 
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BASIC 


e IBM SAA AD/Cycle RPG/400 programming language 


Also, you can use DDS (data description specifications) to describe physical files 
whose fields are used as variables in your programs. A section is included to 
describe how you can define fields that are valid for the (nonarray) parameters on 
calls to graphics routines. 


Internally, IBM AS/400 BASIC uses a form of array that is incompatible with the 
form required by OS/400 Graphics. Therefore, you must use CALL GDDM to start 
any OS/400 Graphics routine that requires array parameters. Another advantage of 
using CALL GDDM is the additional error handling provided to help you diagnose 
data type errors. 


AS/400 BASIC does not support character strings longer than 255 characters, thus 
limiting the use of OS/400 Graphics routines that can accept longer strings (such as 
GSIMG to draw graphics images). 


Calling Graphics Routines in BASIC 
In this book, the syntax for GSCHAR, which is representative of the other OS/400 
Graphics routines, is as follows: 


GSCHAR(x,y, length, string) 
In BASIC, the CALL statement for an OS/400 Graphics routine would look like: 
CALL GDDM('GSCHAR',X,Y,LENGTH,STRING$) 


where the name of the graphics routine is passed as a parameter in the same way 
as all parameters shown in parentheses in this book. The parameters passed to 
GDDM must be of the appropriate data type, as described below. 


Data Types in BASIC 

In BASIC, the name of the OS/400 Graphics routine is passed as a parameter on 
the CALL statement. It is easy to specify it as a character constant. For the other 
parameters passed to GDDM, you must use specific data types. For example, in 


CALL GDDM('GSCHAR',X,Y,LENGTH, STRING$) 
the parameters must have the following data types: 
e X and Y must be floating-point numbers 
e LENGTH must be a 4-byte binary integer 
¢ STRING must be a character string 
The following describes how to specify these data types in BASIC: 


e Four-byte binary integers: You can specify either a variable name or a numeric 
literal with no decimal value specified (such as 1). 


When a parameter is returned to your program by GDDM, you must specify a 
variable, not a literal, to receive the value returned by GDDM. This most 
frequently occurs on the query routines. 


When specifying an integer variable, the INTEGER statement is used, as in the 
following example: 


INTEGER LENGTH 
where the variable LENGTH becomes a 4-byte binary integer. 
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Floating-point numbers: You can specify either a variable name or a numeric 
constant with a decimal value specified (such as 1.0 or 4.5). A numeric 
constant like 1E0 is treated as a floating-point number. Numeric constants like 
1 are treated as integers and would cause an error if passed when a 
floating-point number is required. 


When a parameter is returned to your program by GDDM, you must specify a 
variable, not a constant, to receive the value returned by GDDM. This most 
frequently occurs on the query routines. 


When specifying a variable name on the CALL statement, specify the 
DECIMAL statement earlier in the program. In BASIC, numeric variables 
default to DECIMAL unless you specify an INTEGER statement for them. 
Specifying DECIMAL ensures that the correct data type is passed to GDDM. 
The DECIMAL statement is used in this book for this reason. The following 
example shows the DECIMAL statement: 


DECIMAL X 


Character strings: You can use a variable name ending in $ or a character 
constant as a parameter on the CALL. One exception is when a parameter is 
returned to your program by GDDM. In this case, you must specify a variable, 
not a constant, to receive the value returned by GDDM. This most frequently 
occurs on the query routines. 


When specifying a variable name, for a variable length of more than 18, you 
must specify a DIM statement, as follows: 

DIM STRING$*20 
where the variable STRING$ is 20 bytes long. 
Arrays of 4-byte binary integers: Specify the INTEGER statement as in the 
following example: 


OPTION BASE 1 
INTEGER ARRAY1 
DIM ARRAY1(4) 


where the array named ARRAY1 has four elements that are 4-byte binary 
integers. 


Arrays of floating-point numbers: Specify the DECIMAL statement as in the 
following example: 


OPTION BASE 1 


DECIMAL ARRAY2 
DIM ARRAY2(4) 


where the array named ARRAVY2 is an array with four elements that are 
floating-point numbers. 


Arrays of character strings: Use an array name ending in $. You must specify 
a DIM statement, as follows: 


OPTION BASE 1 
DIM ARRAY$(4)*20 


where the array ARRAY$ has four elements, each 20 bytes long. 


Note: When a character array is used as a parameter that is returned by 
GDDM, the exact length must be specified in a DIM statement. For 
examples, see the descriptions of DSQDEV and GSQSS. 


The COBOL/400 Language 


The COBOL/400 language does not support floating-point data. Therefore, you 
must use CALL GDDM to invoke any graphics routine that requires floating-point 
parameters. Another advantage of using CALL GDDM is the additional error 
handling provided to help you diagnose data type errors. 


Calling Graphics Routines in the COBOL/400 Language 
In this book, the syntax for GSCHAR, which is representative of the other OS/400 
Graphics routines, is as follows: 


GSCHAR(x,y, length, string) 
In the IBM COBOL/400 language, the CALL statement is as follows: 
CALL "GDDM" USING GSCHAR,X,Y,LEN,STR. 


where GSCHAR, X, Y, LEN, and STR are program variables defined as shown in 
“Data Types in the COBOL/400 Language.” 


Data Types in the COBOL/400 Language 

In the COBOL/400 language, the name of the OS/400 Graphics routine is passed 
as a parameter on the CALL statement. The name of the OS/400 Graphics routine 
must be specified in the DATA DIVISION as a data item 8 bytes long. For 
example: 


77. GSCHAR PIC X(8) VALUE "GSCHAR". 


For the other parameters passed to GDDM, you must use specific data types. For 
example, in 


CALL "GDDM" USING GSCHAR,X,Y,LEN,STR. 
the parameters must have the following data types: 
¢ X and Y must be floating-point numbers 
e LENGTH must be a 4-byte binary integer 
¢ STR must be a character string 


The following describes how to specify these data types in the COBOL/400 
language: 


¢ Four-byte binary integers: In the COBOL/400 language, for program-described 
variables, use PICTURE S9(n) COMPUTATIONAL-4, where n must be 5 through 9. 
For example: 


03 LEN PIC $9(5) COMP-4. 
¢ Floating-point numbers: In the COBOL/400 language, floating-point numbers 

cannot be defined. Therefore, you should specify them as packed or zoned 
decimal variables. For packed variables, use PICTURE S9(n)V9(m) 
COMPUTATIONAL-3 where n plus m is less than or equal to 18. For zoned, use 
PICTURE S9(n)V9(m) DISPLAY where n plus mis less than or equal to 18. 
For packed: 

03 X PIC $9(5)V9 COMP-3. 

03 Y PIC $9(5)V9 COMP-3. 
For zoned: 


@3 X PIC $9(5)V9 DISPLAY. 
@3 Y PIC $9(5)V9 DISPLAY. 
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Use zoned decimal data if your program is to prompt the work station user for 
data to be displayed (this avoids the necessity of a conversion). Use packed 
decimal data to reduce the storage requirements of your program. 


Character strings: |In the COBOL/400 language, for program-described 
variables, use PICTURE X(n) DISPLAY where n is the length of the largest 
character string to be moved into the variable. In the COBOL/400 language, 
character variables default to DISPLAY. This book shows DISPLAY to ensure 
that the correct data type is passed to GDDM. For example: 


@3 STR PIC X(10) DISPLAY. 


Arrays of 4-byte binary integers: Define a one-dimensional table using the 
OCCURS clause in the Working-Storage Section as follows: 


Q1 X-VALUES. 
@3 X-VAL OCCURS n TIMES PIC S9(5) COMP-4. 


where X-VAL is the name of the parameter you pass to GDDM, n is the 
number of elements in the array, and X-VAL is the name by which you refer to 
elements of the array. 


Note: If you pass a 01 level name to OS/400 Graphics, results are 
unpredictable. You must pass the data name for which the OCCURS 
clause is specified. 


Arrays of floating-point numbers: Define a one-dimensional table using the 
OCCURS clause in the Working-Storage Section as shown in the following 
examples: 


Q@1 X-VALUES. 
@3 X-VAL OCCURS n TIMES PIC S$9(5)V9 COMP-3. 


or 
@3 X-VAL OCCURS n TIMES PIC S$9(5)V9 DISPLAY. 


where X-VAL is the name of the parameter you pass to GDDM, n is the number 
of elements in the array, and X-VAL is the name by which you refer to elements 
of the array. For the PICTURE clause, follow the same rules as for 
floating-point numbers. 


Note: If you pass a 01 level name to OS/400 Graphics, results are 
unpredictable. You must pass the data name for which the OCCURS 
clause is specified. 


Arrays of character strings: Define a one-dimensional table using the OCCURS 
clause in the Working-Storage Section as follows: 


O01 CHARACTER-ARRAY. 
@3 STR OCCURS n TIMES PIC X(m) DISPLAY. 


where STR is the name of the parameter you pass to GDDM, n is the number of 
elements in the array, STR is the name by which you refer to elements of the 
array, and m is the length of the strings in the array. 


Note: If you pass a 01 level name to OS/400 Graphics, results are 
unpredictable. You must pass the data name for which the OCCURS 
clause is specified. 


PL/I 


Calling Graphics Routines in PL/I 
To call OS/400 Graphics routines in IBM AS/400 PL/I programs, you cannot use 
CALL GDDM; you must call OS/400 Graphics routines directly. 


In this book, the syntax for GSCHAR, which is representative of the other OS/400 
Graphics routines, is as follows: 


GSCHAR(x,y, length, string) 
To call OS/400 Graphics routines in PL/I programs, use a CALL like the following: 
CALL GSCHAR(X,Y,LEN,STR) ; 


where GSCHAR is an entry point declared elsewhere in the program and X, Y, LEN, 
and STR are program variables defined as shown in “Data Types in PL/I.” 


Data Types in PL/I 


In PL/I, you need two sets of declarations: 
e ENTRY declarations for each graphics call used in the program 


e Data type declarations for each parameter you pass as a variable name on 
graphics calls in the program 


ENTRY Declarations: To specify ENTRY declarations for graphics calls in a PL/I 
program, you can specify a declaration for each graphics call, as follows: 


DECLARE GSCHAR 
EXTERNAL 
ENTRY (FLOAT DECIMAL (6), 
FLOAT DECIMAL (6), 
FIXED BINARY (31), 
CHAR (+)) 
OPTIONS (ASM) ; 


where the data types, in the ENTRY declaration above, should match in number 
and type the parameters that will be passed with the call. In the ENTRY 
declaration, use FLOAT DECIMAL (6) for floating-point numbers; use FIXED BINARY 
(31) for 4-byte binary integers; use CHAR (*) for character strings. Also, 
OPTIONS(ASM) is required if, and only if, arrays or character strings are used in the 
call. 


Instead of declaring an ENTRY declaration for each graphics call you intend to use, 
you can include one or more of the sets of PL/I ENTRY declarations that IBM 
supplies (in file QATTPL1 in library QUSRTOOL). These declarations have 
parameter descriptions that match exactly the parameter specifications in the 
descriptions of the CALL statements. To include these IBM-supplied declarations in 
your PL/I program, specify INCFILE(QUSRTOOL/QATTPL1) on the Create PL/I Program 
(CRTPLIPGM) command and do the following in your source program: 


e If you are only using GDDM routines and not Presentation Graphics routines, 
specify: 


%INCLUDE SYSLIB (ADMUPLNB) ; 


e If you are using both GDDM routines and Presentation Graphics routines, 
specify: 


%INCLUDE SYSLIB (ADMUPLNO) ; 
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As an alternative, you can use the following in any combination: 


For GDDM routines beginning with the letter A, specify: 
%INCLUDE SYSLIB (ADMUPINA); 

For routines beginning with the letter C (the Presentation Graphics routines), 

specify: 
%INCLUDE SYSLIB (ADMUPINC); 

For GDDM routines beginning with the letter D, specify: 
%INCLUDE SYSLIB (ADMUPIND) ; 

For GDDM routines beginning with the letter F, specify: 
%INCLUDE SYSLIB (ADMUPINF); 

For GDDM routines beginning with the letter G, specify: 
%INCLUDE SYSLIB (ADMUPING); 


It is convenient to specify these include statements at the end of your PL/I program 
so that line numbering in the compiler listing more closely matches the line 
numbering in your source program. 


Data Type Declarations: When you specify numeric or character constants on 
calls to OS/400 Graphics routines, you need not use data type declarations. 


For program variables used on calls to OS/400 Graphics, you need data type 
declarations as follows: 


e Four-byte binary integers. \|n PL/I, for program-described variables, use a 


declaration like the following: 
DECLARE LEN BINARY FIXED(31); 


Floating-point numbers. Data type declarations for floating-point numbers 
should match the ENTRY declarations you use. If they do not match, PL/I 
converts them to the correct format. If they do match, no conversion is 
required and better performance is obtained. 


When using IBM-supplied ENTRY declarations, your declaration should look 
like the following: 


DECLARE X FLOAT DECIMAL(6); 


When specifying your own ENTRY declarations, use a declaration like one of 
the following: 


— For floating-point decimal variables: 
DECLARE X FLOAT DECIMAL(n); 


where X is a variable name and n is 1 through 6 (should be the same as in 
your ENTRY declaration). 


— For floating-point binary variables: 
DECLARE X FLOAT BINARY(n); 


where X is a variable name and n is 1 through 24 (same as in your ENTRY 
declaration). 
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¢ Character strings: In PL/I, for program-described variables, use a declaration 
like the following: 


DECLARE STR CHARACTER(n); 


where STR is the name of the variable and n is the number of bytes in the 
variable. 


Note: You must not specify the VARYING attribute. 


e Arrays of 4-byte binary integers: Declare an array as follows (for an array of 
four 4-byte binary integers): 


DECLARE ARRAY1(4) STATIC FIXED BINARY(31) INIT(1,2,3,4); 


where ARRAY1 is the parameter you pass with the call, 4 is the number of 
elements in the array, and INIT specifies the initial values of the array 
(optional). OS/400 PL/I requires STATIC when you use INIT. 


e Arrays of floating-point numbers: Declare an array as follows: 
DCL ARRAY1(4) STATIC FLOAT DEC(n) INIT(1.5, 2.2, 3.6, 4.0); 


where ARRAY1 is the parameter you pass with the call, 4 is the number of 
elements in the array, nis from 1 through 6, and INIT specifies the initial 
values of the array (optional). PL/I requires STATIC when you use INIT. 


e Arrays of character strings: Declare an array as follows: 
DCL ARRAY1(4) STATIC CHAR(n) INIT('A','B','C','D'); 
where ARRAY1 is the parameter you pass with the call, 4 is the number of 
elements in the array, n is the length of the elements of the array (in this 


instance 1 would be enough), and INIT specifies the initial values of the array 
(optional). PL/I requires STATIC when you use INIT. 


Note: You must not specify the VARYING attribute. 
Pascal 


Calling Graphics Routines in Pascal 
When calling OS/400 Graphics routines in IBM AS/400 Pascal programs, you 
cannot use CALL GDDM; you must call OS/400 Graphics routines directly. 


In this book, the syntax for GSCHAR, which is representative of other OS/400 
Graphics routines is as follows: 
GSCHAR(x,y, length, string) 


To call OS/400 Graphics routines in Pascal, use a call like the following: 
GSCHAR(X,Y,LEN, STR) ; 


where GSCHAR is an entry point declared elsewhere in the program and X, Y, LEN, 
and STR are program variables defined as shown in “Data Types in Pascal” on 
page 1-10. 
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Data Types in Pascal 
In Pascal, you need three sets of declarations: 


e PROCEDURE declarations for each graphics call used in the program. 


e TYPE declarations for each variable type you use which is not a predefined 
Pascal type. 


e VAR declarations for each parameter you pass as a variable name on graphics 
calls in the program. 


Procedure Declarations: To specify PROCEDURE declarations for graphics calls 
in a Pascal program, you can specify a declaration for each graphics call as 
follows: 


PROCEDURE GSCHAR(VAR X,Y : SHORTREAL; 
VAR LEN : INTEGER; 
VAR STR : CHARARR_ 132); 
NONPASCAL ; 


The data types in the PROCEDURE declaration must match in number and type 
the parameters that will be passed with the call. In the PROCEDURE declaration, 
use SHORTREAL for floating point numbers; use INTEGER for 4-byte binary integers; 
use CHARARR__n (in this case 132) for character strings. Also, the reserved word 
NONPASCAL is required on all OS/400 Graphics routine declarations. 


Instead of declaring a PROCEDURE declaration for each graphics call you intend 
to use, you can include one or more of the sets of Pascal PROCEDURE 
declarations that IBM supplies (in file QATTPAS in library QUSRTOOL). These 
declarations have parameter descriptions that match exactly the parameter 
descriptions of the CALL statements. To include these IBM-supplied declarations in 
your Pascal program, do the following: 


e If you are using only GDDM routines and not Presentation Graphics routines, 
specify : 
%INCLUDE QATTPAS (ADMUSLNB) ; 


e If you are using both GDDM routines and Presentation Graphics routines, 
specify: 


%INCLUDE QATTPAS (ADMUSLNO) ; 


As an alternative, you can use the following in any combination: 
¢ For GDDM routines beginning with the letter A, specify: 
%INCLUDE QATTPAS (ADMUSINA) ; 


e For routines beginning with the letter C (the Presentation Graphics routines), 
specify: 


%INCLUDE QATTPAS (ADMUSINC) ; 

¢ For GDDM routines beginning with the letter D, specify: 
%INCLUDE QATTPAS (ADMUSIND) ; 

¢ For GDDM routines beginning with the letter F specify: 
%INCLUDE QATTPAS (ADMUSINF) ; 

¢ For GDDM routines beginning with the letter G, specify: 
%INCLUDE QATTPAS (ADMUSING) ; 
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In Pascal programs, it is required to specify that these include statements be 
specified immediately after the VAR declarations, and before any FUNCTION 
declarations, or at the beginning of the program. 


TYPE Definitions: To specify TYPE definitions for graphics calls containing 
user-defined types in a Pascal program, you can specify a definition for each 
user-defined type required. For the GSCHAR PROCEDURE declaration, on page 
1-10, the following would be a required TYPE definition: 


TYPE 
CHARARR_132 = PACKED ARRAY[1..132] OF CHAR; 


Instead of defining a TYPE definition for each user-defined type required for 
graphics calls you intend to use, you can include the TYPE definitions that IBM 
supplies (in file QATTPAS in library QUSRTOOL). This include statement has 
TYPE definitions that match exactly those user-defined types used in the 
IBM-supplied PROCEDURE declarations. To use these IBM-supplied TYPE 
definitions in your Pascal program, do the following. 


TYPE 
% INCLUDE QATTPAS (ADMUSTNO) ; 


In Pascal programs, it is required that this include statement be specified within the 
TYPE definitions of your program. 


VAR Declarations: Pascal requires that all non-Pascal procedures pass 
parameters only by reference. Because of this requirement, all OS/400 Graphics 
routine parameters must be type VAR in Pascal programs. Numeric or character 
constants on calls to OS/400 Graphics routines are not allowed. 


For program variables used on calls to OS/400 Graphics, you need VAR 
declarations as follows: 


e Four-byte binary integers: In Pascal, for program-described variables, use a 
declaration like the following: 


VAR 
LEN : INTEGER; 


¢ Floating-point numbers: Data type declarations for floating point variables must 
match the PROCEDURE declarations you use. If they do not match, Pascal 
will generate a compiler error and the Create Pascal Program (CRTPASPGM) 
command will fail. In Pascal, for program-described variables, use a 
declaration like the following: 


VAR 
X : SHORTREAL; 


¢ Character strings: Data type declarations for character strings must match the 
PROCEDURE declarations you use. If they do not match, Pascal will generate 
a compiler error and the CRTPASPGM (Create Pascal Program) command will 
fail. In Pascal, for program-described variables, use a declaration like one of 
the following: 
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VAR 
STR : ARRAY[1..n] OF CHAR; 
STR : PACKED ARRAY[1..n] OF CHAR; 
STR : STRING(n); 
STR : CHARARR_n; 
STR : ALFA; 
STR : ALPHA; 


where STR is the name of the variable, and n is the number of bytes in the 
variable. As noted above, the PROCEDURE declaration must match the 
variable declaration exactly. In the IBM-supplied PROCEDURE declarations, 
character strings are defined as either CHARARR_n or ALFA. ALFA is a 
predefined type used for 8-character strings, and is equivalent to PACKED 
ARRAY [1..8] OF CHAR. CHARARR_n is used for varying length strings, 
where n is the length of the character string (typically 132), and CHARARRF_n is 
a user-defined type declared in the IBM-supplied TYPE definitions (in member 
ADMUSTNO, file QATTPAS, library QUSRTOOL) as in the following: 


TYPE 
CHARARR_n = PACKED ARRAY[1..n] OF CHAR; 


e Arrays of 4-byte integers: Declare an array as one of the following (for an array 
of five 4-byte binary integers): 
VAR 


ARRAY1 : ARRAY[1..5] OF INTEGER; 
ARRAY1 : INTARR_5; 


where ARRAY 1 is the name of the variable, 1..5 is the range of the array, and 
INTEGER is the type of the element in the array. In the IBM-supplied 
PROCEDURE declarations, integer arrays are defined as INTARR_n, where n 
is the length of the array, and INTARR_n is a user-defined type declared in the 
IBM-supplied TYPE definitions (in member ADMUSTNO, file QATTPAS, library 
QUSRTOOL) as in the following: 


TYPE 
INTARR_n = ARRAY[1..n] OF INTEGER; 


e Arrays of floating-point numbers: Declare an array as one of the following: 


VAR 
ARRAY1 : ARRAY[1..5] OF SHORTREAL; 
ARRAY1 : REALARR_5; 


where ARRAY 1 is the name of the variable, 1..5 is the range of the array, and 
SHORTREAL is the type of element in the array. In the IBM-supplied 
PROCEDURE declarations, shortreal arrays are defined as REALARR_n, 
where n is the length of the array, and REALARR_n is a user-defined type 
declared in the IBM-supplied TYPE definitions (in member ADMUSTNO, file 
QATTPAS, library QUSRTOOL) as in the following: 


TYPE 
REALARR_n = ARRAY[1..n] OF SHORTREAL; 


e Arrays of character strings: Declare an array as in any of the following: 
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VAR 
ARRAY1 : ARRAY[1..5] OF PACKED ARRAY[1..8] OF CHAR; 
ARRAY1 : ARRAY[1..5] OF STRING(8); 
ARRAY1 : ARRAY[1..5] OF ALFA; 
ARRAY1 : ARRAY[1..5] OF ALPHA; 
ARRAY1 : ALFAARR_5; 
ARRAY1 : NAMEARR_5; 


where ARRAY 1 is the name of the variable, 1..5 is the range of the array, and 
the type of element in the array is a string of characters. In the case of ALFA 
and ALPHA, these are Pascal predefined types. ALFA is equivalent to 
PACKED ARRAY{1..8] OF CHAR and ALPHA is equivalent to PACKED 
ARRAY[1..16] OF CHAR. In the IBM-supplied PROCEDURE declarations, 
character arrays are defined as ALFAARR_n, where n is the length of the 
array, and ALFAARR_n is a user-defined type declared in the IBM-supplied 
TYPE definitions (in member ADMUSTNO, file QATTPAS, library QUSRTOOL) 
as the following: 


TYPE 
ALFAARR_n = ARRAY[1..n] OF ALFA; 


or as NAMEARR_n, where n is the length of the array, and NAMEARRF_n is a 
user-defined type declared in the IBM-supplied TYPE definitions as in the 
following: 


TYPE 
NAMEARR_n = ARRAY[1..n] OF CHARARR_m; 


Chapter 1. Introduction 1-13 


OS/400 Graphics routines often have parameters which are defined as having 
varying lengths. For example, the GSCHAR routine defines its last parameter, 
STRING, simply as a character string, with no length specified. Pascal, unlike 
some other languages, does not allow a variable to be of undefined length (with the 
exception of the predefined tyoe STRING, which due to the way in which it is 
processed by Pascal, cannot be used for OS/400 Graphics routines). 


This means that lengths must be specified for varying length parameters before 
they may be used in a Pascal program. The IBM-supplied INCLUDE of TYPE 
definitions (member ADMUSTNO in file QATTPAS in library QUSRTOOL) define 
several array and character string types of specific lengths. These type definitions 
are used in the IBM-supplied include statements of PROCEDURE declarations. 
These same TYPE definitions must also be used in the VAR declarations for the 
corresponding variables to be passed as parameters on graphics calls in Pascal 
programs. 


If you want to use the GSCHAR routine in your Pascal program, here is what the 
IBM-supplied declarations look like for TYPE and PROCEDURE: 


TYPE 
CHARARR_132 = PACKED ARRAY[1..132] OF CHAR; 


PROCEDURE GSCHAR(VAR I,J : SHORTREAL; VAR K : INTEGER; 
VAR L : CHARARR_132); NONPASCAL; 


The VAR declarations used in your program would have to look like the following: 


VAR 
X,Y : SHORTREAL; /* Correspond to I,J above «/ 
A : INTEGER; /* Corresponds to K above *«/ 
CHARSTRING : CHARARR_132; /* Corresponds to L above */ 


And the actual call in your program would look like the following: 
GSCHAR(X,Y,A,CHARSTRING) ; 


In most cases, the maximum value allowed by GDDM for the varying length 
parameter is the length specified in the IBM-supplied TYPE definitions. However, 
where this is not efficient (for example, the maximum length allowed is 32,000 
bytes), a length is selected which is long enough to handle a typical case, yet still 
be efficient. 


If it becomes necessary to change any of the procedure or type declarations 
supplied by IBM, it is suggested that the user make copies of these include 
statements in a personal library, then modify them as necessary for particular 
applications. Users must then ensure consistency on the PROCEDURE, TYPE, 
and VAR declarations and place the personal library containing these declarations 
in front of QUSRTOOL in the *LIBL in order to use the include statements in Pascal 
programs. 


Following are the PROCEDURE declarations from the IBM-supplied include 
statements which contain varying length parameters: 
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Figure 1-1 (Page 1 of 3). Procedure Declarations. Declarations for IBM-supplied 
include statements which contain varying length parameters. 


PROCEDURE CHAATT(VAR I : INTEGER; VAR J : INTARR 12); 
NONPASCAL; 
PROCEDURE CHBAR(VAR I,J : INTEGER; VAR K : REALARR_ 20); 
NONPASCAL; 
PROCEDURE CHBATT(VAR I : INTEGER; VAR J : INTARR 3); 
NONPASCAL; 
PROCEDURE CHCOL(VAR I : INTEGER; VAR J : INTARR 32); 
NONPASCAL; 
PROCEDURE CHDATT(VAR I : INTEGER; VAR J : INTARR 3); 
NONPASCAL; 
PROCEDURE CHGATT(VAR I : INTEGER; VAR J : INTARR 12); 
NONPASCAL; 
PROCEDURE CHHATT(VAR I : INTEGER; VAR J : INTARR 4); 
NONPASCAL; 
PROCEDURE CHHEAD(VAR I : INTEGER; VAR J : CHARARR 132); 
NONPASCAL; 
PROCEDURE CHHIST(VAR I,J : INTEGER; VAR K,L,M : REALARR 20); 
NONPASCAL; 
PROCEDURE CHKATT(VAR I : INTEGER; VAR J : INTARR 4); 
NONPASCAL; 
PROCEDURE CHKEY(VAR I,J : INTEGER; VAR K : CHARARR_132); 
NONPASCAL; 
PROCEDURE CHLATT(VAR I : INTEGER; VAR J : INTARR 6); 
NONPASCAL; 
PROCEDURE CHLT(VAR I : INTEGER; VAR J : INTARR 32); 
NONPASCAL; 
PROCEDURE CHLW(VAR I : INTEGER; VAR J : REALARR 32); 
NONPASCAL; 
PROCEDURE CHMARK(VAR I : INTEGER; VAR J : INTARR 32); 
NONPASCAL; 
PROCEDURE CHNATT(VAR I : INTEGER; VAR J : INTARR 6); 
NONPASCAL; 
PROCEDURE CHNOTE(VAR I : CHARARR_2; VAR J : INTEGER; 
VAR K : CHARARR 132); NONPASCAL; 
PROCEDURE CHPAR(VAR I : INTEGER; VAR J : INTARR 32); 
NONPASCAL; 
PROCEDURE CHPCTL(VAR I : INTEGER; VAR J : REALARR_1); 
NONPASCAL; 
PROCEDURE CHPEXP(VAR I : INTEGER; VAR J : INTARR 32); 
NONPASCAL; 
PROCEDURE CHPIE(VAR I,J : INTEGER; VAR K : REALARR_ 20); 
NONPASCAL; 
PROCEDURE CHPLOT(VAR I,J : INTEGER; VAR K,L : REALARR_ 20); 
NONPASCAL; 
PROCEDURE CHSET(VAR I : ALFA); 
NONPASCAL; 
PROCEDURE CHSURF(VAR I,J : INTEGER; VAR K,L : REALARR_ 20); 
NONPASCAL; 
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Figure 1-1 (Page 2 of 3). Procedure Declarations. Declarations for IBM-supplied 
include statements which contain varying length parameters. 


PROCEDURE CHTATT(VAR I : INTEGER; VAR J : INTARR 4); 
NONPASCAL; 


PROCEDURE CHVATT(VAR I : INTEGER; VAR J : INTARR 4); 
ONPASCAL; 


PROCEDURE CHXLAB(VAR I,J : INTEGER; VAR K : CHARARR_132); 
ONPASCAL; 


PROCEDURE CHYLAB(VAR I,J : INTEGER; VAR K : CHARARR_132); 
ONPASCAL; 


PROCEDURE CHXLAR(VAR I : INTEGER; VAR J : INTARR 6); 
ONPASCAL; 


PROCEDURE CHYLAT(VAR I : INTEGER; VAR J : INTARR 6); 
ONPASCAL; 


PROCEDURE CHXSET(VAR I : ALFA); 
ONPASCAL; 


PROCEDURE CHYSET(VAR I : ALFA); 
NONPASCAL; 


PROCEDURE CHXTTL(VAR I : INTEGER; VAR J : CHARARR 132); 
NONPASCAL; 


PROCEDURE CHYTTL(VAR I : INTEGER; VAR J : CHARARR_132); 
NONPASCAL; 


PROCEDURE DSOPEN(VAR I,J : INTEGER; VAR K : ALFA; 
VAR L : INTEGER; VAR M : INTARR_9; 
VAR N : INTEGER; VAR O : NAMEARR 2); 
NONPASCAL; 


PROCEDURE DSQDEV(VAR I : INTEGER; VAR J : ALFA; 
VAR K : INTEGER; VAR L : INTARR_9; 
I 


VAR M : INTEGER; VAR N : NAMEARR_2; 
VAR 0 : INTEGER; VAR P : INTARR_15); 
NONPASCAL; 

PROCEDURE FSEXIT(VAR I : ALFA; VAR J : INTEGER); 
NONPASCAL; 

PROCEDURE FSDEV(VAR I : INTEGER; VAR J : INTARR 15); 
NONPASCAL; 

PROCEDURE FSQERR(VAR I : INTEGER; VAR J : CHARARR_564); 
NONPASCAL; 

PROCEDURE GSCHAP(VAR I : INTEGER; VAR J : CHARARR_132); 
NONPASCAL; 


PROCEDURE GSCHAR(VAR I,J : SHORTREAL; VAR K : INTEGER; 
VAR L : CHARARR 132); 


NONPASCAL; 
PROCEDURE GSCTD(VAR I,J,K : INTEGER; VAR L,M,N : 
REALARR_7) NONPASCAL; 
PROCEDURE GSGET(VAR I : INTEGER; VAR J : CHARARR_400; 
VAR K : INTEGER); NONPASCAL; 
PROCEDURE GSGETS(VAR I : INTEGER; VAR J : INRARR 1); 
NONPASCAL; 
PROCEDURE GSIMG(VAR I,J,K,L : INTEGER; VAR M : CHARARR_ 2040); 
NONPASCAL; 
PROCEDURE GSIMGS(VAR I,J,K,L : INTEGER; VAR M : CHARARR 2040; 
VAR N,O : SHORTREAL) ; NONPASCAL; 
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Figure 1-1 (Page 3 of 3). Procedure Declarations. Declarations for IBM-supplied 
include statements which contain varying length parameters. 


PROCEDURE GSLSS(VAR I : INTEGER; VAR J : ALFA; VAR L : INTEGER); 
NONPASCAL; 

PROCEDURE GSMRKS(VAR I : INTEGER; VAR J,K : REALARR_20); 
NONPASCAL; 

PROCEDURE GSPFLT(VAR I : INTEGER; VAR J,K : REALARR_20); 
NONPASCAL; 

PROCEDURE GSPLNE(VAR I : INTEGER; VAR J,K : REALARR_20); 
NONPASCAL; 

PROCEDURE GSPUT(VAR I,J : INTEGER; VAR K : CHARARR_400) ; 
NONPASCAL; 

PROCEDURE GSQCTD(VAR I,J,K : INTEGER; VAR L,M,N : REALARR 8); 
NONPASCAL; 

PROCEDURE GSQSS(VAR I : INTEGER; VAR J : INTARR 20; 
VAR K : ALFAARR_20; VAR L : INTARR_20); 
NONPASCAL; 


PROCEDURE GSQTB(VAR I : INTEGER; VAR J : CHARARR 132; 
VAR K : INTEGER; VAR L,M : REALARR_5); 
NONPASCAL; 


PROCEDURE GSVECM(VAR I : INTEGER; VAR J : INTARR 20); 
NONPASCAL; 


Following are the IBM-supplied TYPE definitions: 


Figure 1-2 (Page 1 of 2). IBM-Supplied TYPE Definitions 


REALARR_1 = ARRAY[1..1] OF SHORTREAL; 
REALARR_5 = ARRAY[1..5] OF SHORTREAL; 
REALARR_7 = ARRAY[1..7] OF SHORTREAL; 
REALARR_8 = ARRAY[1..8] OF SHORTREAL; 


REALARR_20 = ARRAY[1..20] OF SHORTREAL; 


REALARR_32 = ARRAY[1..32] OF SHORTREAL; 


INTARR_1 = ARRAY[1..1] OF INTEGER; 


INTARR_3 = ARRAY[1..3] OF INTEGER; 


INTARR_4 = ARRAY[1..4] OF INTEGER; 


INTARR_6 = ARRAY[1..6] OF INTEGER; 


INTARR_9 = ARRAY[1..9] OF INTEGER; 


INTARR_12 = ARRAY[1..12] OF INTEGER; 


INTARR_15 = ARRAY[1..15] OF INTEGER; 


INTARR_20 = ARRAY[1..20] OF INTEGER; 


INTARR_32 = ARRAY[1..32] OF INTEGER; 


CHARARR_2 = PACKED ARRAY[1..2] OF CHAR; 


CHARARR_10 = PACKED ARRAY[1..10] OF CHAR; 


CHARARR_132 = PACKED ARRAY[1..132] OF CHAR; 


CHARARR_400 = PACKED ARRAY[1..400] OF CHAR; 


CHARARR_564 = PACKED ARRAY[1..564] OF CHAR; 


CHARARR_2040 = PACKED ARRAY[1..2040] OF CHAR; 
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Figure 1-2 (Page 2 of 2). IBM-Supplied TYPE Definitions 
NAMEARR_2 = ARRAY[1..2] OF CHARARR_10; 
ALFAARR_20 = ARRAY[1..20] OF ALFA; 


The RPG/400 Language 


The IBM RPG/400 language does not support floating-point data. Therefore, you 
must use CALL GDDM to call any graphics routine that requires floating-point 
parameters. Another advantage of using CALL GDDM is the additional error 
handling provided to help you diagnose data type errors. 


Calling Graphics Routines in the RPG/400 Language 
In this book, the syntax for GSCHAR, which is representative of the other OS/400 
Graphics routines, is: 


GSCHAR(x,y, length, string) 


To call OS/400 Graphics routines in RPG/400 programs, use one of the following 
forms of the CALL operation code. 


e¢ When specifying the parameters separately: 
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See Note 1 


See Note 2 
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In the above example GSCHAR, X, Y, LEN, and STR are program variables 
defined as shown in “Data Types in the RPG/400 Language” on page 1-20. 
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Notes: 


1. In the RPG/400 language, you cannot specify a character literal in positions 
42 through 49 on a PARM statement. You must specify an 8-byte 
character field in positions 43 through 48. You can define the field on the 
PARM statement by specifying its length (8) in position 51 (leaving position 
52 blank makes it a character field). Also, you can initialize the field on the 
PARM statement by specifying its value in positions 34 through 42, as 
shown. 


2. LEN is a binary field and must be defined using a data structure input 
specification (see four-byte binary integers on page 1-21). 
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When specifying the parameters in a parameter list (PLIST): 
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See Note 1 


See Note 2 
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In the above example GSCHAR, X, Y, LEN, and STR are program variables 
defined as shown in “Data Types in the RPG/400 Language” and CHARPL is a 
parameter list defined at [EJ and used on the call at [. 


Notes: 


1. In the RPG/400 language, you cannot specify a character literal in positions 
42 through 49 on a PARM statement. You must specify an 8-byte 
character field in positions 43 through 48. You can define the field on the 
PARM statement by specifying its length (8) in position 51 (leaving position 
52 blank makes it a character field). Also, you can initialize the field on the 
PARM statement by specifying its value in positions 34 through 42, as 
shown. 


2. LEN is a binary field and must be defined using a data structure input 
specification (see four-byte binary integers on page 1-21). 


Data Types in the RPG/400 Language 

In the RPG/400 language, you cannot specify a numeric literal in positions 41 
through 49 on a PARM statement; you must use variables (called subfields or fields 
in the RPG/400 language). 


For the other parameters passed to GDDM, you must use specific data types. 
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In this example the parameters must have the following data types: 


e X and Y must be floating-point numbers. 
e LEN must be a 4-byte binary integer. 
¢ STR must be a character string. 


The following describes how to specify these data types in the RPG/400 language: 


¢ Four-byte binary integers: In the RPG/400 language, for program-described 
variables, specify a data structure and at least one subfield on input 
specifications as in the following example: 
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In the data structure statement: 


— PARAMS is the name of the data structure (this is required by the RPG/400 
language when more than one data structure is used in the program and is 
shown here for illustration). 


In the data structure subfield specifications: 
— B specifies that the field is binary 


— 1 and 4, and 5 and 8 specify the from and to positions of the two subfields 
in this data structure 


— 0 specifies the number of decimal places and makes these fields integers 
— LEN and COUNT are the names of the fields. 


¢ Floating-point numbers: In the RPG/400 language, floating-point numbers 
cannot be defined. Therefore, you should use packed decimal or zoned 
decimal fields. The data is converted to floating-point when you call a graphics 
routine using CALL GDDM. A numeric field that is part of an externally 
described file is a packed decimal field in RPG/400 programs. 


To specify a packed decimal field in your program, specify the field on 
calculation specifications as follows: 


— In positions 49 through 51: Specify 1 through 15, right justified (this is the 
length of the variable). 


— In position 52: Specify 0 through 9 (this is the number of decimal positions 
in the field and makes it a numeric field). 


The following is an example of packed decimal fields: 
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To specify a zoned decimal field in your program, specify the field as a subfield 
in a data structure as follows: 
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In the data structure statement: 


— SAMPLE is the name of the data structure (this is required by the RPG/400 
language when more than one data structure is used in the program and is 
shown here for illustration). 


In the data structure subfield specifications: 


Position 43 is blank for zoned decimal data 


1 and 4, and 5 and 8 specify the from and to positions of the two subfields 
in this data structure 


1 specifies the number of decimal places and makes these fields numeric 
fields 


— Xand Y are the names of the fields. 


¢ Character strings: In the RPG/400 language, for program-described variables, 
use a character field, defined as follows on calculation specifications: 


— In positions 49 through 51: Specify the length of the variable, right justified. 


— In position 52: Leave blank (this makes the variable a character variable). 
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In the following example, a character field (STR), which is used with the PARM 
operation code, is defined to be 12 bytes long: 
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e Arrays of 4-byte binary integers: You must specify a binary array. To define a 
binary array, you must first define the array using an RPG extension 
specification, then redefine the array as a binary data structure using input 
specifications. 


You can specify the array as a compile-time array, an execution-time array, or 
a pre-execution time array. A compile-time array sets the array to the same 
initial values each time the program is run. With execution-time arrays, the 
program changes the values of array elements as the program runs. For 
example, the program might read data in from the display device to set the 
values of the array elements. This section describes compile-time arrays. For 
a description of execution-time arrays and pre-execution time arrays, refer to 
the RPG/400 Reference book. 


The following shows the extension specification defining the array: 
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RPG EXTENSION AND LINE COUNTER SPECIFICATIONS ST aine 


Printed in U.S.A. 


Intemational Business Machines Corporation 


12 75 76 77 78 79 80 
Pr : Graph Card Electro Numb 
rogram Punching raphic ard Electro Number Page of Prosram 
Programmer Date Instruction | punch 
Extension Specifications 
E Record Sequence of the Chaining File 
Number of the Chaining Field 2 2 
Number] Number Sis 9 | 
of of Length | |@|G] Tableor Length | fa [2 
: Table or ; 3 |<] AmayName ° |< 
Line To Filename AnayN Entries | Entries of af i of ie |= Comments 
ay ray Name Ese Slo} (Altemating Ent IK |o 
2 Per PerTable Y |e 8/2} fomat) nty |e fe |o 
fe From Filename Record | orAnay SES SIE 5 
E aly le alge 
2 = }O |& = lO Jk 
3 4 5|{6]7 8 {9 10/11 12 13 14 15 16 17 18}19 20 21 22 23 24 25 26/27 28 29 30 31 32}33 34 35] 36 37 38 39/40 41 42/43 |44|45|46 47 48 49 50 51/52 53 54]55|56/57] 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 
oli| |E XVIALL UIE 1 4 (a) 
o|2| |E 
0/3 E | i Li | 
p+ een 
| —~| 
oj4| |E [LL “J 
LL oo 
o|5| |E p Jt A] 
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In this example, XVALUE is the name of the array (and the name of the 
parameter that is passed on the call to a graphics routine), 1 is the number of 
entries (array elements) on each array input record (these are specified in the 
source member after the last RPG specification), 4 is the number of elements 
in the array, 9 is the length of each element in the array (for 4-byte integers), 
and 0 specifies the number of decimal positions in each element (making it a 
numeric array). 


The following shows the input specifications that redefine the array XVALUE as 
a binary data structure: 


RPG INPUT SPECIFICATIONS GxaL-Sose. UM/Os0r 
Intemational Business Machines Corporation nnted in U.S.A. 
" Bie 75 76 77 78 79 80 
Program Keying Graphic Card Electro Number Page of Program 
Programmer ae Instruction [oy Identification 
l - Extemal Field Name iets 
s Field Location Fe 
® Indicators 
: 2 Record Identification Codes 
Filename 3 
or = wn a & 
§ 
Record Name Sas 1 2 3 5 8 
wl jes From To © RPG q |[Su/8 
wf a S + =. sie 
, S/3/5,- ra $| Field Name = |e2la 
Line = _|e* 2 ca) vo ve Zero 
© S|ole« 5 a Pak} & 2 JE= |S |eius |minus| or 
Q = |S |= 2 2 2 Data Structure = S lee] 3 Bric 
‘i I> a Ss ¥ I> hie o rr} =" Oo lan 
a Data olal [2 Isls Postion |Zla]s| Postion /Zlals| Postion [Elole|2 |S £ B leel|e2 
E Structure ElS|3 > |N 8 z Q|s Is IN lo |e Occurs Length G 2 |fs] 2 
© Name aln|ol2lo|= IS O|S Z/o]6 ZO |G1e Jz] Times a 6 |so|e2 
3.4 5/6|7 8 9 10 11 12 [13 |14/15]16] 17/18/19 20] 21 22 23 24 |25 [26 |27 |28 29 30 31 [32 |33 134/35 36 37 38/39 /40]41/42|43|44 45 46 47/48 49 50 51/52/53 54 55 56 57 58|59 60/61 62|63 64/65 66/67 68/69 70/71 72 73 74! 
O12] [Ex Ale D |s nN 
0| 2 I 
B 1 1|6|O|X|VIA|L|U/E| pl 
0] 3 I 
0] 4 I | J 1_| 
it — —o 
[J CI 
o| 5 ] | b+ | 
LLlolel II [ | t+ a 
See Note 1 
See Note 2 
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Notes: 


1. This is the data structure statement. XVAL is a dummy value not used 
elsewhere in the program. DS identifies the statement as a data structure 
statement. 


2. In this statement, B specifies binary data, 1 and 16 specify the beginning 
and ending points of the array (16 is four times the number of array 
entries), and XVALUE is the name of the array that this data structure is 
redefining. 


A sample set of values could be: 
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“AQUGIB Kien Kew ped 12d syaaus yo 1aquNNy. 


123 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 Gl 62 63 64 65 66 67 68 69 70 71 72 
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e Arrays of floating-point numbers: |In the RPG/400 language, specify either a 
packed decimal or zoned decimal array. The data is converted to floating-point 
when you call a graphics routine using CALL GDDM. 


You can specify the array as a compile-time array, an execution-time array, or 
a pre-execution time array. A compile-time array sets the array to the same 
initial values each time the program is run. With execution-time arrays, the 
program changes the values of array elements as the program runs. for 
example, the program might read data in from the display device to set the 
values of the array elements. This section describes compile-time arrays. For 
a description of execution-time arrays and pre-execution time arrays, refer to 
the RPG/400 Referencebook. For a sample execution-time array in a graphics 
program, refer to the GDDM Programming book. 


If you use zoned decimal fields, you must first define the array using an RPG 
extension specification, then redefine the array as a zoned decimal data 
structure using input specifications. When you use packed decimal fields, you 
need only define the array using an RPG extension specification. Therefore, 
packed decimal arrays are easier to specify than zoned decimal arrays. 


The following shows the extension specification defining a compile-time array: 


RPG EXTENSION AND LINE COUNTER SPECIFICATIONS oS Brean USA: 


Intemational Business Machines Corporation 


12 75 76 77 78 79 80 
Page of 


Program Graphic Card Electro Number 


Punching 
Programmer Date Instruction pinek 


Identification 


Extension Specifications 


E Record Sequence of the Chaining File 
Number of the Chaining Field 4 a 
Number} Number Sis 5 |x 
ei 
Tabieer of of Length ae Pee Rome | Length | fa |e 
Line |, To Filename AnayName | Entries | Entries of aT] atematin Ff 2 = Comments 
& Per Pertable | Enty |e [S/S] fomay |Erty Ja fa |S 
re From Filename Record | orAmay SE 1S SIE |S 
E @\9 le aly je 
Q & 
2 a a |B = |o Jk 
3 4 5]6]7 8 }9 1011 12 13 14 15 16 17 18/19 20 21 22 23 24 25 26/27 28 29 30 31 32|33 34 35} 36 37 38 39}/40 41 42/43 |44|45|46 47 48 49 50 51/52 53 54]55|56|57] 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74| 
o|i| |E SIAIMIPIL |E 1 4 5| 10 
o|2| |E 
o/3| JE | | J 4 es 
| + — 
[J L | 
0/4 E | 1- oN 
= ~~ 
o|5| |E [Jie {| 
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In this example: 
SAMPLE is the name of the array. 


1 is the number of entries (array elements) on each array input record 
(these are specified in the source member after the last RPG specification). 


4 is the number of elements in the array. 


5 is the length of each element in the array (1 through 15 for floating-point 
numbers). 


0 specifies the number of decimal positions in each element. 


The following shows input specifications that redefine the array SAMPLE as a 
zoned decimal data structure (not needed for packed decimal data): 


= RPG INPUT SPECIFICATIONS 21-5096 UI O50 
= = Intemational Business Machines Corporation Printed in U.S.A. 
- i 7576 77 78 79 80 
Program Keying Graphic Card Electro Number page sf Program 
Instruction Identification | | | 
Programmer Date Key 
l " Extemal Field Name a 
g Field Location idieatols 
© 
_ 2 Record Identification Codes 
ilename 
Ey # 5 
Record Name 20 1 2 3 ayy = 
wl Jes From To c RPG q [ou s 
S|s}s_- So | Field Name = jee/a 
Line Ee ee Re 2 a o 22) Zero 
5 ala/o« i L ar} é rea sd 6 | Plus Minus] or 
y lols 2 ey 2 Data Structure = 2/22] 3 Blank 
I> 4 > : > & la 5 l|sé 
r= Data IS lcle Position |Zla|s| Postion |Zla]}g| Position |Z la|s|o |S E g jEe|a 
ol[R S I= © iS © i= © oO £ Bilge 
E Structure Elale 3 [RI rea BIRIE(8 |B] ntimes length |g 6 je£| 
& Name aln}o|z fo]® iz JoJo 2 |olo 2 |o|G]& je] 7 times a Oo jz0le@ 
3.4 5|6|7 8 9 10 11 12 )13 [1415 | 16] 17] 18|19 20] 21 22 23 24 [25 [26 |27 |28 29 30 31/32 |33 [34/35 36 37 38 |30|40|41]42/43|44 45 46 47/48 49 50 51|52|53 54 55 56 57 58/59 60/61 62/63 64|65 66] 67 68|69 70| 71 72 73 74] 
O12) TEISIMPIL DS Li 
o}?| 1 ZOO|SIA\MIPIL |E| p! 
0| 3 I 
o| 4 I | J L_| 
pt n= a | 
ols I [lt LT | 
[4 L | 
Llobet |y [ [14 a 
See Note 1 
See Note 2 
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1. This is the data structure statement. SMPL is a dummy value not used 
elsewhere in the program. DS identifies the statement as a data structure 
statement. 


2. In this statement, 1 and 20 specify the beginning and ending points of the array 
(20 is the length of an array item times the number of array entries), and 
SAMPLE is the name of the array that this data structure is redefining. 


A sample set of values could be: 
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“AQUGIB Kien Kew ped sad syaaus Jo 1aquNNy. 
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e Arrays of character strings: You can specify the array as a compile-time array, 
an execution-time array, or a pre-execution time array. A compile-time array 
sets the array to the same initial values each time the program is run. With 
execution-time arrays, the program changes the values of array elements as 
the program runs. For example, the program might read data in from the 
display device to set the values of the array elements. This section describes 
compile-time arrays. For a description of execution-time arrays and 
pre-execution time arrays, refer to the RPG/400 Referencebook. For a sample 
execution-time array in a graphics program, refer to the GDDM Programming 
book. 


The following shows the extension specification defining a compile-time array: 


RPG EXTENSION AND LINE COUNTER SPECIFICATIONS OF omeain usa: 
= Printed in U.S.A. 
= Intemational Business Machines Corporation 
12 75 76 77 78 79 80 
Pr , Graph Card Electro Numb 
=— Punching | “EE ee na ae Page| | of Beeson 
Programmer Date Instruction | punch 
Extension Specifications 
E Record Sequence of the Chaining File 
Number of the Chaining Field ¢ 4 
Number] Number Sis 9 |~ 
of of Length | |a|G] Tableor Length | fa |2 
; Table or o|€] ArayName ° | 
Line |q To Filename ArayName | Entries | Entries of 215} (attemating of a |S Comments 
ES Per PerTable | Entry |x |e |v Format) Entry Jas |e 
= From Filename Record | orAnay SES SES 
E aly le aly le 
2 = Jo |% =O /& 
3 4 5|6]7 8 {9 10/11 12 13 14 15 16 17 18}19 20 21 22 23 24 25 26/27 28 29 30 31 32}33 34 35] 36 37 38 39/40 41 42/43 |44|45|46 47 48 49 50 51]52 53 54]55|56/57] 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 
ofi| |E SIT |R 1 4| (1/2 
o|2| |E 
o|3| |E |_| 4 —l| 
p+ ae 
| | 
o|4 E | 1- mL] 
L— oo 
ols] |E pjJt— a 
— i — 
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In this example STR is the name of the array, 1 is the number of entries (array 
elements) on each array input record (these are specified in the source 
member after the last RPG specification), 4 is the number of elements in the 
array, and 12 is the length of each element in the array. 


A sample set of values could be: 


“ANUBIS Kien Aew ped sad gaays yo 1aquinny. 

1 (2 3 4 = & L 8 2 0 11 1213 14 15 16/17 1819 20 21 22 23 4 25 76 27 {28,29 30 31 32 3334 35 36 37 38 39 40 41 42 43 (4 45 46 47 4849 50 51 52°53 54 55 56 57 5859 60 G1 62 63 64 65 66 67 68 69 10-71 72 
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Data Description Specifications 


Data Types in Data Description Specifications 

To use externally described data in your programs, you define files on the AS/400 
system using data description specifications (DDS), then name the files in your 
programs. The fields defined in the files become variables in your programs. For 
example, using DDS, you can define a display file by which your program reads in 
data keyed by the work station user. You can also define a field reference file to 
standardize parameters used in your programs (you cannot define arrays in DDS). 
According to the data type, specify: 


¢ Four-byte binary integers: In DDS, for a field in a physical file: 
— In positions 19 through 28, specify the name of the parameter. 
— In positions 30 through 34, specify 5 through 9 (to give a 4-byte field). 
— In position 35, specify B (for binary). 
— In positions 36 through 37, specify 0 (defines an integer field). 


Here is an example of a 4-byte binary field: 


£5 AS/400 DATA DESCRIPTION SPECIFICATIONS 441 991-000 /050" 
== Intemational Business Machines C orporation PrintedinU.S.A 
File Graphic Description 
Keying p P' Page of 
Instruction 
Programmer Date Key 
A | Conditioning =o 
ez e ee 
< 3 8) OB 
S vo ip = 
= ConditionName | 8 g = 
Sequence 2 5 Name Length 2 FS Location Functions 
Number £ 2 le @ < 
E E lS Ea iS: 
«| . L L 6 @ 3} |S} 
g/9/-| 8 j=} 2 |2| 2 |Z 2 25 2|S|] Line | Pos 
Flsl2| 8 (2/8 |2| 8 |e 7 ® 68(8 
Elsle| £ [e/ 2 je] 2 Jelg Ke 8) 0 %|> 
6} 0 |s|/> jel Jal o 
2/Z\z| £ ize j2z\s |Ae Ks 8se|8 
12,3 4 5| 6! 7| 8] 910 [11 [12 13 [14 [15 16 |17 |18 |19 20 21 22 23 24 25 26 27 28|29|30 31 32 33 34/35/36 37/38/39 40 41/42 43 44/45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 
itt a iti tdi rit isi ial [iil 
tt tales el 1 tt 
A \ (eeimeee i i 
1 ae es 
A Pot tt eee Oe 
itt it 
, He tel 
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In this example LEN is the name of the field. 
¢ Floating-point numbers: |In DDS, for a field in a physical file: 
— In positions 19 through 28, specify the name of the parameter. 


— In positions 30 through 34, specify 5 through 9 (for single precision, which 
is the same as short precision). 


In position 35, specify F (for floating-point). 
— In positions 36 through 37, specify 0 through 9. 


1-32 AS/400 GDDM Reference 


Here is an example of a floating-point field: 


z AS/400 DATA DESCRIPTION SPECIFICATIONS er oie 


Intemational Business Machines C orporation Printed inU.S.A. 


File keying Graphic Description Page of 
Programmer Date aE NOD) key 
Al Conditioning =o 
2VZ ie —~ 
£ s 5 g 
g : y z = 
Sequence # <n 7 a Name Length 2 : Location Functions 
Number = © lac gy = 
ofs| | s a wal Jo 3 S 
g/2\-| £ |-/ 2 |=) 2 |=/B rs Sig els] line Pos 
Fiolé| & <1 8 |<) 8 Is g ries 2 
12.3 4 5) 6) 7) 8) 910/11 [12 13 |14 |15 16 |17|18|19 20 21 Seri te ee gl tric tee ee ei re ee ee er eee 
ites pe ' i ' it lr i rida 
HHH Ht 
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In this example X is the name of the field. 
¢ Character strings: In DDS, specify the following for a field in a physical file: 
— In positions 19 through 28, specify the name of the parameter. 
— In positions 30 through 34, specify the length of the largest character string 
you will use for the parameter. 
— Leave position 35 blank (it defaults to character). 
— Leave positions 36 through 37 blank. 
The following is an example of a character field: 
Intemational Business Machines C orporation AS/400 DATA DESCRIPTION SPECIFICATIONS rae Tor atie 
File Keying Graphic Description Page of 
Programmer Date ern Key 
A | Conditioning =o 
ez € cae 
z s i s 
2 ‘ y re < 
Sequence 4 fui . a Name Length lo E Location Functions 
Number 2 ® lz K} = 
ere )). |]. lg ls 5\_ |S 
Blgla| 8 [e/8 |e] 8 EE Fi Sle ele] ie | Pes 
else £ (ElE (E}E ale FE asa 
ree” cae: ee sale 8 siuhelioasha he ack haligtauas 22 23 24 25 26 27 28/29/30 31 32 33 34/35136 37|38|39 40 41/42 43 44145 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 
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In this example STR is the name of the field. 
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GDDM Routines 


Chapter 2. GDDM Routines 


GDDM Concepts 


Figure 2-1 lists GDDM routines according to their function. 


For the System/370* graphics functions, see Appendix A, “Conversion and 
Compatibility.” 


© Copyright IBM Corp. 1994 2-1 


GDDM Routines 


Figure 2-1. Graphics Routines Available in GDDM 


Drawing Pictures 


Setting color attributes 


¢ Selecting a color directly 
¢ Selecting a color indirectly 
¢ Color mixing 


Current position 


GSCOL,GSQCOL 
GSCTD,GSCT,GSQCTD,GSQCT 
GSMIX 


GSMOVE,GSQCP 


Drawing lines 


e Line attributes 
¢ Straight lines 
¢ Curved lines 


GSLT,GSQLT,GSLW,GSQLW,GSFLW,GSQFLW 
GSLINE,GSPLNE,GSVECM 
GSARC,GSPFLT,GSELPS 


Drawing filled areas 


GSAREA,GSENDA,GSPAT,GSQPAT 


Drawing graphics symbols 


¢ Controlling symbol sets 


GSLSS,GSRSS,GSQNSS,GSQSS 


¢ Selecting the current symbol set GSCS,GSQCS 

¢ Drawing graphics symbols GSCHAP,GSCHAR 

¢ Setting attributes for graphics symbols 
— Character mode GSCM 
— Size GSCB,GSQCB,GSQTB,GSQCEL,GSSEN,GSQSEN 
— Angle GSCA,GSQCA 
— Direction GSCD,GSQCD 
— Shear GSCH,GSQCH 

Drawing graphics images GSIMG,GSIMGS 


Drawing markers 


GSMS,GSQMS,GSMSC,GSQMSC,GSMARK,GSMRKS 


Controlling the Graphics Environment 


Program controls 


¢ Graphics program controls 
e Error handling controls 
e Display controls 
e Picture controls 

— Page 

— Graphics field 

— Picture space 

— Viewport 

— Window 

— Graphics segment 

— Graphics clipping 


FSINIT,FSRNIT,FSTERM 
FSEXIT,FSQERR 
ASREAD,FSFRCE,FSREST 


FSPCRT,FSPDEL,FSPCLR,FSPSEL,FSPQRY,FSQCP 
GSFLD,GSCLR 

GSPS,GSQPS 

GSVIEW,GSQVIE 

GSWIN,GSQWIN 

GSSEG,GSSCLS,GSSDEL 

GSCLP,GSQCLP 


Device controls 


¢ Opening and closing devices 
e Using devices 
¢ Querying the device characteristics 


DSOPEN,DSCLS,DSQUID 
DSUSE,DSDROP,DSQUSE,GSQCUR 
DSQDEV,FSQDEV 


¢ Sounding the device alarm FSALRM 

Graphics data format (GDF) file 
e Retrieving graphics data GSGET,GSGETE,GSGETS 
e Drawing data from a GDF GSPUT 
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Alphabetic List of GDDM Calls 


Syntax Rules 


In this section, the GDDM routines, with their syntax and explanations, are listed 
alphabetically. 


The syntax is followed by a description of the routine, an explanation of the 
parameters, and a sample of the call in BASIC. For information on calling graphic 
routines in other languages, see “High-Level Languages” on page 1-2. 


The syntax shown for each GDDM routine includes all the parameters required for 
calling it. 


Each parameter shown is required; that is, if you use the routine, you must specify 
something for each parameter, even if your program does not use the parameter or 
if the parameter is ignored on the AS/400 system. (This happens when the 
function of the parameter is used on the System/370 computer but is not needed 
on the AS/400 system.) 


The syntax shown for each GDDM routine is not a complete CALL statement in any 
language. Only the parts of the syntax that are specific to OS/400 Graphics are 
presented. This emphasizes the important aspects of the call. You must code a 
valid CALL statement in the language you are using. For example, 


GSCHAR(x,y,length, string) 
is representative of the syntax in this book. However, you would code 
CALL GDDM('GSCHAR',3.5,4.5,23,'Sample character string') 
in a BASIC program and 
CALL GSCHAR(3.5,4.5,LENGTH, 'Sample character string'); 
in a PL/I program. 


You must specify the correct data types in your program. If the data types do not 
match those required by OS/400 Graphics, undesirable results, possibly even a 
function check, can occur. For more details on coding graphics calls in various 
languages, see “High-Level Languages” on page 1-2. 


The parameter names have been chosen to be meaningful. For example, in 


GSCHAR(x,y, length, string) 


x and y define a coordinate position in a Cartesian coordinate system (which 
traditionally shows the horizontal axis as the x axis and the vertical axis as the y 
axis), length gives the length of the string, and string is a character string to be 
shown. 
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ASREAD 


ASREAD-Device Output/Input 


ASREAD (function-key-type, F-key-number, count) 


Performs all outstanding graphics output. When the current device is a display 
station, ASREAD waits for the user to press a function key in response to the 
display. When the response is received, the type of function key and (if the key is 
an F key) the F key number are returned. GDDM waits for a user response even if 
no graphics are sent. 


When the device is a plotter or printer, graphics are sent to the device and program 
processing continues as if FSFRCE were specified. A warning error occurs 
because no input can be received from the device (this is also true for dummy 
devices). 


Parameters 
function-key-type (returned by GDDM) (4-byte binary integer variable) 
It is one of the following: 


0 Enter key. 

1 F key. 

5 Clear key. 

6 Other: The user has pressed one of the following keys: Help, Home, 
Print, Roll Up, or Roll Down. The value for F key-number is undefined. 

7 Output-only device: The primary device accepts only output, and does 
not return input; the values for F key-number and count are undefined. A 
warning error is returned to emphasize this situation. 


F-key-number (returned by GDDM) (4-byte binary integer variable) 
If the function-key-type parameter is 1, this is the number of the function key 
that was pressed. For example, if F12 was pressed, F-key-number is 12. 


count (returned by GDDM) (4-byte binary integer variable) 
It is always 0. 


Coding Example 

In this example, if the work station user presses the F1 key, FKEY is 1, FNUM is 1, 
and COUNT is 0. If the work station user presses the Help, Home, Print, Roll Up, 
or Roll Down key, FKEY is 6, FNUM is undefined, and COUNT is 0. 


INTEGER FKEY,FNUM, COUNT 
CALL GDDM('ASREAD' , FKEY, FNUM, COUNT) 


Differences between the System/370 Computer and the AS/400 


System 
On the AS/400 system, the following function-key-type values are not supported: 


2 Light pen 
3 Badge reader 
4 Cp key. 
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DSCLS-Close Device 


DSCLS(device-id,option) 


Terminates the use of a device by GDDM. Any resources (such as symbol sets, 
page contents, or color tables) that have been defined for the device are released. 
Any device that is subsequently opened with the same device-id bears no 
relationship to the device now being closed. 


Any usage currently in force for this device is discontinued. 


Note that DSCLS differs from most GDDM routines, because it attempts to 
complete even if an error is returned. 


On display devices, any graphics at the device, even if not displayed, are erased 
when this routine is called. 


Parameters 
device-id (4-byte binary integer) 
The device identifier of the device to be closed. 


option (4-byte binary integer) 
Must be zero on the AS/400 system. 


Coding Example 
In the following example, the device with identifier 2 is closed and, if it is a display, 
any graphics at the device are erased: 


CALL GDDM('DSCLS',2,0) 


Here 0 is a place holder for the option parameter (all parameters must be specified 
on calls to graphics routines). To give a device an identifier, use DSOPEN. 


Differences between the System/370 Computer and the AS/400 
System 

On the System/370 computer, you can specify an option to keep the graphics at the 
device; on the AS/400 system, the graphics are always erased. 
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DSDROP-Line Device Usage 


DSDROP(usage,device-id) 


Causes a device to no longer operate with the specified usage. The device now 
enters a state in which the only operations that can be performed against it are 
DSCLS, DSRNIT, DSQDEV, and DSUSE. Its resources are not, however, 
released, and its usage (together with all such resources as page contents, symbol 
sets, and color tables that existed at the time of the DSDROP) can be subsequently 
restored by means of a DSUSE. 


Parameters 
usage (4-byte binary integer) 
The device usage code, which must take the following value: 


1 Current primary device. 


device-id (4-byte binary integer) 
The identifier of the device to be discontinued. 


Coding Example 

In the following example, the program first uses device 2 as the primary device, 
then drops the use of device 2 as primary device and starts using device 3 as the 
current primary device. 


CALL GDDM('DSUSE' ,1,2) 


CALL GDDM('DSDROP',1,2) 
CALL GDDM('DSUSE',1,3) 


To give a device an identifier, use DSOPEN. 
Differences between the System/370 Computer and the AS/400 


System 
On the AS/400 system, secondary device support (usage 2) is not provided. 
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DSOPEN-Open Device 


DSOPEN(device-id family device-token,procopt-count,procopt-list, 
name-count,name-list) 


Opens a device to be used for graphics. DSOPEN gives the device a device 
identifier and describes the device to GDDM. 


If you call DSOPEN, you must also call DSUSE before the device becomes the 
current device. 


Parameter Summary 

The use of the various parameters is summarized below to give a quick overview. 
device-id (number used by other GDDM calls including DSUSE and DSCLS) 
user-defined: | Cannot be negative and should not be 0. 

family 

1 Graphics work station, plotter, or graphics-capable printer. 

device-token (name from a list of device descriptions) 


* ' 


Actual device used is determined at execution time 


“PLOT ' Device is any available plotter 
'5292M2 ' Device is a 5292 Model 2 or a personal computer configured as a 
5292 


'5555MG01' The device is an IBM PS/55 configured as a 5555 Model G01. 
'5555MG02' The device is an IBM PS/55 configured as a 5555 Model G02. 


‘6180 ' Device is an IBM 6180 Plotter attached to a graphics work station 

‘6182 ' Device is an IBM 6182 Plotter attached to a graphics work station 

‘6184 = ' Device is an IBM 6184 Plotter attached to a graphics work station 

‘6185 Device is an IBM 6185 Plotter attached to a graphics work station 

‘6186M1 ' Device is an IBM 6186-1 Plotter attached to a graphics work 
station 

‘6186M2 ' Device is an IBM 6186-2 Plotter attached to a graphics work 
station 

‘7371 ' Device is an IBM 7371 or 6180 Plotter attached to a graphics work 
station 

‘7372 = ' Device is an IBM 7372 Plotter attached to a graphics work station 

‘L79A3_ Device token used to obtain graphics data format (GDF) files. 
Only valid for dummy device support. 

'B22X Device is an IBM 5224 or 5225 Printer 

4214 ' Device is an IBM 4214 Printer 

IPDS ' Device is an IPDS Printer, such as an IBM 4224 Printer 

4234 = ' Device is an IBM 4234 Model 2 Printer. 


procopt-count (number of items in procopt-list) 


0 Procopt-list is empty 
2 through 11 Number of items in procopt-list 


procopt-list (processing options) 


10 Plotter form feed (2 items) 
11. Plotter pen velocity (2 items) 
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12 Plotter pen width (2 items) 
15 Plotter paper size (3 items) 
16 Plotter paper orientation (2 items) 


name-count (number of elements in name-list) 


0 Name-list is empty 
1 Name-list contains one name 
2 Name-list contains one display device description name and a plotter address. 


name-list (device description name or a special value) 


First element: 


a ' “REQUESTOR device or default printer file Q@GDDM 

‘name OS/400 device description name of graphics work station 

' ' Dummy device 

‘printer-file ' Name of the user-defined printer file or the IBM-supplied 
printer file QPGDDM. 


Second element: 


‘ nn' Two-character address of plotter, right justified in character 
string 
‘ADMPLOT _ ' Use lowest address of available plotters of the type specified in 


the device token. 


For coding examples, see page 2-18. 


Parameters 
device-id (4-byte binary integer) 
The device identifier. The device identifier must not be negative. 


Avoid 0 because GDDM uses 0 as the default device identifier. 


Note that GDDM issues an internal DSOPEN request to open the default 
primary device (device-id is 0). This occurs when you do not use DSOPEN. 


family (4-byte binary integer) 
The device family code, which must take the following value: 


1 Graphics work station, IBM plotter, graphics-capable printer, or the 
dummy device support provided by device token L79A3. 


device-token (8-byte character string) 
Names a group of properties that apply to specific devices. You can specify 
the following values: 


q : At execution time, GDDM determines the device properties 
from the value of the name-list parameter and the OS/400 
device description (*DEVD) for the display device being used. 
For the actual device used, see Figure 2-2. 


No procopts can be specified for use with this token 
(procopt-count must be 0), and the name-list is ignored. 


“PLOT ' When no address is specified in the second element of the 
name-list array, the device is the first available plotter (the 
plotter at the lowest address). If an address is specified, the 
device is whatever type of plotter that is configured at that 
address. 
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'5292M2 ' 


‘'5555MG01' 
‘S555MG02' 


‘6180 


‘6182 


‘6184 


‘6185 


‘'6186M1 ' 


‘'6186M2 ' 


‘7371 


DSOPEN 


The device is an IBM 5292 Display Station Model 2, or an IBM 
Personal Computer configured as a 5292 Model 2 


No procopts can be specified for use with this token 
(procopt-count must be 0), and the name-list is ignored. 


The device is an IBM PS/55 configured as a 5555 Model G01. 
The device is an IBM PS/55 configured as a 5555 Model G02. 


The device is an IBM 6180 Plotter that is attached to a 
graphics work station. The plotter device must be specified on 
the device description of the graphics work station (AUXDEV 
parameter of the CRTDEVDSP (Create Device Description 
(Display)) or the CHGDEVD (Change Device Description) 
command). 


The device is an IBM 6182 Plotter that is attached to a 
graphics work station. The plotter device must be specified on 
the device description of the graphics work station (AUXDEV 
parameter of the CRTDEVDSP (Create Device Description 
(Display)) or the CHGDEVD (Change Device Description) 
command). 


The device is an IBM 6184 Plotter that is attached to a 
graphics work station. The plotter device must be specified on 
the device description of the graphics work station (AUXDEV 
parameter of the CRTDEVDSP (Create Device Description 
(Display)) or the CHGDEVD (Change Device Description) 
command). 


The device is an IBM 6185 Plotter that is attached to a 
graphics work station. The plotter device must be specified on 
the device description of the graphics work station (AUXDEV 
parameter of the CRTDEVDSP (Create Device Description 
(Display)) or the CHGDEVD (Change Device Description) 
command). 


The device is an IBM 6186-1 Plotter that is attached to a 
graphics work station. The plotter device must be specified on 
the device description of the graphics work station (AUXDEV 
parameter of the CRTDEVDSP (Create Device Description 
(Display)) or the CHGDEVD (Change Device Description) 
command). 


The device is an IBM 6186-2 Plotter that is attached to a 
graphics work station. The plotter device must be specified on 
the device description of the graphics work station (AUXDEV 
parameter of the CRTDEVDSP (Create Device Description 
(Display)) or the CHGDEVD (Change Device Description) 
command). 


The device is an IBM 7371 or 6180 Plotter that is attached to 
a graphics work station. The plotter device must be specified 
on the device description of the graphics work station 
(AUXDEV parameter of the CRTDEVDSP (Create Device 
Description (Display)) or the CHGDEVD (Change Device 
Description) command). 


Chapter 2. GDDM Routines 2-9 


DSOPEN 


‘7372 The device is an IBM 7372 Plotter that is attached to a 
graphics work station. The plotter device must be specified on 
the device description of the graphics work station (AUXDEV 
parameter of the CRTDEVDSP (Create Device Description 
(Display)) or the CHGDEVD (Change Device Description) 
command). 


No processing options can be specified for use with the following device tokens 
(that is, the processing option count must be 0): 


'B22x = The device is an IBM 5224 or 5225 Printer. 
4214S ' The device is an IBM 4214 Printer. 
4234 ~S' The device is an IBM 4234 Model 2 Printer. 


You can supply your own printer file via the name list 
parameter when using any of the device tokens. 


‘L79A3 S' This token always results in dummy device support, and is 
intended for use in the generation of GDF (see GSGET later in 
this chapter) at a level similar to that produced by the same 
token on the System/370 computer. The GDF produced when 
this token is used is more compact than that produced when 
other tokens are used. 


For this token, the name-list is ignored because dummy device 
support is always assumed. 


This token does not provide graphics support for IBM 3279 
displays remotely attached to the AS/400 system. 


The processing options for paper orientation can be specified for use with the 
following printer device token: 


IPDS ' The device is a printer that accepts an intelligent printer data 
stream (IPDS). This device token is used to access any 
supported IPDS printer, including the 3812, 3816, 4028, and 
4224 printers. 


GDDM left-justifies the supplied parameter, and converts it to uppercase, if 
necessary. 


Figure 2-2 shows the type of device support that results from various 
combinations of the device-token and name-list parameters. 


Figure 2-2 (Page 1 of 2). Devices Supported by DSOPEN Parameters 


Job Type (Job), 
Name-List (NL), 


Device-Tokens 


Device (Dev) 


:. *PLOT 5292M2 | Plotter Printer/IPDS 


Job=Interactive, 
NL=*REQUESTER, 
Dev=display+plotter 


Display Plotter Display Plotter Printer 


Job=Interactive, 
NL=*REQUESTER, 
Dev=display 


Display Plotter Display Dummy | Printer 
plotter 
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Figure 2-2 (Page 2 of 2). Devices Supported by DSOPEN Parameters 

Job=Interactive, Dummy | Dummy | Dummy | Dummy | Printer 
NL=*REQUESTER, display plotter display plotter 
Dev=nongraphics 

Job=Interactive, Display Plotter Display | Plotter Error 
NL=device-name, 

Dev=display+plotter 

Job=Interactive, Display Plotter Display | Dummy | Error 
NL=device-name, plotter 
Dev=display 

Job=Interactive, Dummy | Dummy | Dummy | Dummy | Error 
NL=device-name, display plotter display plotter 
Dev=nongraphics 

Job=Any, Dummy | Dummy | Dummy | Dummy | Dummy 
NL="'" display plotter display plotter printer 
Dev=N/A 

Job=Batch, Dummy | Dummy | Dummy | Dummy | Dummy 
NL=*REQUESTER, display plotter display plotter printer 
Dev=N/A 

Job=Batch, Display Plotter Display | Plotter Error 
NL=device-name, 

Dev=display+plotter 

Job=Batch, Display Plotter Display | Dummy | Error 
NL=device-name, plotter 
Dev=display 

Job=Batch, Dummy | Dummy | Dummy | Dummy | Error 
NL=device-name, display plotter display plotter 
Dev=nongraphics 

Job=Interactive, Error Error Error Error Printer 
NL=printer-file-name, 

Dev=Any 

Job=Batch, Error Error Error Error Printer 
NL=printer-file-name, 

Dev=N/A 


Note: For printer or IPDS device tokens, device support depends upon whether 
the printer file (QPGDDM or user-defined) has been 
created/changed/overridden to SPOOL(*YES) or SPOOL(*NO). 
SPOOL(*YES) will result in a spooled graphics printer file, while 
SPOOL(*NO) will result in immediate output to the printer named in the 
printer file, if it is available. See the following table. 


Figure 2-3 (Page 1 of 2). Printer Device Support 


Name-List (NL), 
Overrides (Ovr) 


SNA Character String 
Printer Device-Token 


Intelligent Printer Data Stream 
Printer Device-Token 


NL=*REQUESTOR, Ovr=None 


Spooled default printer file Q@GDDM 


Spooled default printer file QPGDDM 


NL=printer-file-name, 
Ovr=None 


NL=*REQUESTOR, 
Ovr=FILE(printer-file-name) 


Spooled printer file 'printer-file-name' 


Spooled printer file 'printer-file-name' 


Spooled printer file 'printer-file-name' 


Spooled printer file 'printer-file-name' 
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Figure 2-3 (Page 2 of 2). Printer Device Support 


Name-List (NL), 
Overrides (Ovr) 


SNA Character String 
Printer Device-Token 


Intelligent Printer Data Stream 
Printer Device-Token 


NL=printer-file-name-1, 
Ovr=FILE(printer-file-name-2) 


Spooled printer file 
‘printer-file-name-2' 


Spooled printer file 
‘printer-file-name-2' 


NL=*REQUESTOR, 
Ovr=FILE(printer-file-name), 
DEV(SCS-device-name) 


Spooled printer file 'printer-file-name 
compatible with SCS printer devices 
only 


Spooled printer file 'printer-file-name' 
compatible with IPDS printer devices 
only 


NL=*REQUESTOR, 
Ovr=FILE(printer-file-name), 
DEV(IPDS-device-name) 


Spooled printer file 'printer-file-name 
compatible with SCS printer devices 
only 


Spooled printer file 'printer-file-name' 
compatible with IPDS printer devices 
only 


NL=*REQUESTOR, 
Ovr=DEV(SCS-device-name), 
SPOOL(*NO) 


Direct output to printer 
'SCS-device-name' 


Dummy device support 


NL=*REQUESTOR, 
Ovr=DEV(IPDS-device-name), 
SPOOL(*NO) 


Dummy device support 


Direct output to printer 
‘IPDS-device-name' 


procopt-count (4-byte binary integer) 
Specifies the number of elements in procopt-list. You can specify 0 to indicate 
to GDDM that procopt-list is empty and is not to be inspected. (You must 
specify the procopt-list parameter on the call even if procopt-count is zero.) 


If you are not using the plotter, specify 0. If you can take the plotter defaults, 
specify 0. 


procopt-list (array of 4-byte binary integers) 
Passes miscellaneous processing options to GDDM. 


Each option is passed as an option group, consisting of an option code 
followed by one or more integers of option data. Option groups may be 
specified in any order. Only those option groups for which you specifically 
need to override GDDM’s defaults need be specified. If the option group does 
not apply to the particular device, it must not be specified or an error occurs 
and the DSOPEN operation fails. 


The parameter list takes the form: 


Option Code Option 1 Option Code Option 2 Option 3 
For example, for 8.5 inch by 11 inch transparencies: 
11 30 15 1 2 
In this case, procopt-count would be 5. 
The supported option groups are: 
Option Group Option Number of 
Code Integers 
Plotter form feed 10 2 
Plotter pen velocity 11 2 
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Option Group Option Number of 
Code Integers 

Plotter pen width 12 2 

Plotter paper size 15 3 

Paper orientation 16 2 


Note: The procopt-count is the number of 4-byte integers in the option group, 


including the option code. 
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Valid values for each processing option group and plotter are: 


Processing Option Group 
Plotter 10 11 12 15 16 Notes 
6180 NV 0-100 0-10 0-2 0-2 3 
6182 0-2 0-100 0-10 NV 0-2 2 
6184 NV 0-100 0-10 NV 0-2 
6185 NV 0-100 0-10 NV 0-2 
6186-1 NV 0-100 0-10 0-5 0-2 3 
6186-2 0-2 0-100 0-10 0-5 0-2 1,3 
7371 NV 0-100 0-10 NV NV 
7372 NV 0-100 0-10 0-2 0-2 3 


NV - Processing option group is not valid for this plotter. 


Notes: 


1. Form feed option enables roll feed. 

2. Form feed option enables 8.5 x 11 inch sheet feed. 

3. Value shown for option group 15 is paper size code. The dimension type code 
value is 0-2. 


Processing option group 10: Plotter form feed 


This option group allows the form feed to be specified for the plotter. The form 
feed may be either enabled or disabled. 
This option group has two elements: 

e The option group code is 10. 

e¢ Form feed code: 


0 Default of enabled (same as 2) 
1 Disabled 
2 Enabled 


Processing option group 11: Plotter pen velocity 
This option group gives the relative pen speed to be used by the plotter. The 
default value should be suitable for fiber-tipped pens used on normal paper; when 
transparency pens are used, a slower pen speed, such as 30, might be necessary. 
This option group has two elements, as follows: 

e The option group code is 11. 

e Pen velocity: 


0 Default pen velocity of 100 (the maximum) 
1 through 100: Specified pen velocity as percentage of the maximum velocity 
available on the plotter 
Processing option group 12: Plotter pen width 


This option group gives the width of the pens used in the plotter, and applies to al/ 
pens in the plotter. The pen width is important for fine detail, such as in area fill 
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operations and drawing character strings with small-sized characters. If pens of 
different widths are to be used in the same picture, the pen width should be set to 
the size of the pens that are to be used for the finest detail. 
This option group has two elements: 

e The option group code is 12. 

e Pen width, in units of 0.1 millimeters: 


0 Default pen width of 3 (0.3 mm) 
1 through 10 Specified pen width (0.1 through 1.0 mm) 


Typical pen widths for plotters are 3 (0.3 mm), 6 (0.6 mm), and 7 (0.7 mm). 
Processing option group 15: Plotter paper size 


This option group gives the size of the paper that has been loaded into the plotter. 
See Figure 2-4 for a summary of paper sizes. 


The switches controlling paper size on the plotter must be set to indicate the same 
paper size specified in this option group, or undesired results may occur (Such as 
aspect ratio distortion, mis-centering, or partial picture). 
This option group has three elements: 

e The option group code is 15. 


e Paper size code: 


0 Default of small (same as 1) 
1 A or A4 
2 B or A3 
3 C or A2 
4 D or Al 
5 E or AO 


e Dimension type code: 


0 Default of ISO dimensions (Same as 1) 
1 ISO dimensions (A4, A3, A2, A1, AQ) 
2 ANSI dimensions (A, B, C, D, E) 
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Figure 2-4. Plotter Paper Sizes 
Paper Dimension | Paper | Actual Paper Default Plotting 
Size Type Size Dimensions Area 
Code Code 
1 1 (ISO) A4 210 x 297 mm 179.1 x 248.8 mm 

2 (ANSI) A 8.5 x 11 inches 7.09 x 9.84 inches 
2 1 (ISO) A3 297 x 420 mm 248.8 x 378.1 mm 

2 (ANSI) B 11 x 17 inches 9.84 x 14.96 inches 
3 1 (ISO) A2 420 x 594 mm 334 x 532 mm 

2 (ANSI) C 17 x 22 inches 13.61 x 19.56 inches 
4 1 (ISO) Al 594 x 841 mm 508 x 779 mm 

2 (ANSI) D 22 x 34 inches 18.61 x 31.56 inches 
5 1 (ISO) AO 841 x 1189 mm 779 x 1103 mm 

2 (ANSI) E 34 x 44 inches 31.56 x 40.61 inches 


Processing option group 16: Paper orientation 


This option group allows the paper orientation to be specified for the plotter. The 
paper may be oriented either horizontally, with the long dimension of the paper 
along the x axis, or vertically, with the long dimension of the paper along the y axis. 


Note that this option group does not have anything to do with the way that the 
paper is placed in the plotter; instead it specifies the paper’s orientation relative to 
the x and y directions defined by GDDM. 


When this option group is used, it is especially important to correctly handle the 
picture space definition, because the definition will change depending upon the 
paper orientation chosen. The picture space definition can be queried with GSQPS 
and set with GSPS. 


Horizontal y Vertical y 
orientation orientation 


This option group has two elements: 
e The option group code is 16. 
¢ Orientation: 


0 Default of horizontal orientation (1) 
1 Horizontal 
2 Vertical 
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name-count (4-byte binary integer) 
Specifies the number of 10-byte strings in name-list. Specifying 0 indicates that 
name-list is empty and is not to be inspected. Even if name-list is empty, the 
name-count parameter must be specified in the parameter list of the call. 


name-list (array of one or two 10-byte character string elements) 
Specifies the device description name or a special value. For a plotter, use the 
name of the graphics work station to which the plotter is attached. 


GDDM left-justifies the string and converts it to uppercase, if necessary. 


Even if name-list is empty, its name must be specified in the parameter list of 
the call. 


If the name-count parameter is 0, the device is the ~REQUESTER device or 
default printer file. 


If the name-count parameter is 1, the device is one of the following: 


bed . The device used is *REQUESTER, that is, the current 
interactive work station is to be used. The actual device used 
depends on the device-token parameter. See Figure 2-2 on 
page 2-10 for the actual device used. This is the same as 
specifying zero for the name-count parameter. 
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‘name 


‘printer-file’ 


This is the device description name of a display station 
configured on your system, or, for printer or IPDS device 
tokens, the name of a printer file to be used to spool the 
graphics data. An error occurs if the device is not available 
when the application program is called and this DSOPEN call 
is executed. 


If the device token specified a printer, and no printer file is 
specified, the default printer file QPGDDM is used to format 
output, which is spooled to the appropriate output queue. If 
QPGDDM has been overridden to a specific printer (that is, 
SPOOL(*NO) has been specified), the output will be printed on 
the selected printer (if it is available). See Figure 2-3 on 

page 2-11 for more information. 


The device is a dummy device, (that is, no real device is 
associated with this GDDM device) or the default printer file 
QPGDDM. For dummy device support, GDDM generates the 
data streams required but does not send them to any real 
device, nor does it attempt to receive data from a device. This 
option can be used to check a GDDM application when a real 
device with the necessary features is unavailable. 


The name printer file is used. If QPGDDM is the named 
printer file, processing occurs as if this first element were left 
blank (described above). If a user-defined printer file is named 
in this element, it is used to format the output, and its 
attributes are used to determine whether the output is spooled 
to a particular output queue or sent directly to the printer. 


If the name count is 2, the plotter device is selected, based on either of the 
following entries in the second array element: 


nn 


‘ADMPLOT ' 


The plotter (of the type specified by the device token) at 
address nn is used. The address assigned to the plotter in the 
device description for the associated work station is 
represented in this element by two right-justified characters. 


The plotter (of the type specified by the device token) at the 
lowest address of an available plotter is used. 


Coding Examples 


Example 1: 


The following example opens the *REQUESTER device, that is, the actual device 
from which the program is called, and assigns it a device identifier of 2. If this 
device is a graphics work station, graphics are displayed; if this device is a 
nongraphics device, a diagnostic message is issued for successful execution. 


OPTION BASE 1 


INTEGER PROCOPT LIST 

DIM PROCOPT_LIST(1) 

DIM NAME_LIST$(1)*10 

CALL GDDM('DSOPEN',2,1,'* ',0,PROCOPT LIST(),0,NAME_LIST$()) 
CALL GDDM('DSUSE' ,1,2) 
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Example 2: 


The following example opens the IBM 6180 Plotter, giving it a device identifier of 3. 
The name-list parameter must have the value of the graphics work station device 
description. In addition, this call passes processing option group 11 (so that the 
plotter pen runs slowly for transparencies) and group 12 (so that the lines drawn 
are wider). Each group requires two 4-byte binary integers; therefore there are four 
values in PROCOPT_ LIST. 


OPTION BASE 1 

INTEGER PROCOPT LIST 

DIM PROCOPT_LIST(4) 

MAT READ PROCOPT_LIST 

DATA 11, 30, 12, 7 

DIM NAME_LIST$(1)*10 

LET NAME _LIST$(1) = 'GRFDSP1' 

CALL GDDM('DSOPEN',3,1, '6180 ',4,PROCOPT LIST(),1,NAME_LIST$()) 
CALL GDDM('DSUSE',1,3) 


Example 3: 


The following example opens the 5292 Model 2, giving it a device identifier of 2 and 
the name of its OS/400 device description ((GRFDSP1'). 


OPTION BASE 1 

INTEGER PROCOPT LIST 

DIM PROCOPT_LIST(1) 

DIM NAME_LIST$(1)*10 

LET NAME _LIST$(1) = 'GRFDSP1' 

CALL GDDM('DSOPEN',2,1,'5292M2 ',0,PROCOPT LIST(),1,NAME_LIST$()) 
CALL GDDM('DSUSE' ,1,2) 


Example 4: 


The following example opens the IBM 5555 Model G01, giving it a device identifier 
of 2 and the name of its OS/400 device description ((GRFDSP1’). 


OPTION BASE 1 

INTEGER PROCOPT LIST 

DIM PROCOPT LIST(1) 

DIM NAME_LIST$(1)*10 

LET NAME _LIST$(1) = 'GRFDSP1' 

CALL GDDM('DSOPEN',2,1,'5555MGQ1',0,PROCOPT LIST(),1,NAME_LIST$()) 
CALL GDDM('DSUSE' ,1,2) 


Differences between the System/370 Computer and the AS/400 
System 
On the AS/400 system, device families 2, 3, and 4 are not supported. 


On the AS/400 system, different device tokens are supported. 


On the AS/400 system, different procopt-list option group codes are supported for 
plotters. 


On the AS/400 system, the name-list string is 10 bytes long (instead of 8 bytes) to 
accommodate AS/400 device names. 
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DSQDEV-Query Device Characteristics 


DSQDEV(device-id device-token,procopt-count,procopt-list, 
name-count,name-list,char-count,char-list) 


Returns the characteristics of a device with the specified device identifier. A device 
token, processing options list, and name list are returned in DSOPEN format, 
including the values of any options that were assigned by default when the device 
was opened. A further list containing miscellaneous device characteristics is also 
returned. 


In the count parameters, you must specify how many elements each list has. If 
there is insufficient space, GDDM returns only as many elements as it can; if there 
is extra space, GDDM does not change the excess elements. 


Parameters 
device-id (4-byte binary integer) 
The identifier of the device whose characteristics you are querying. 


device-token (returned by GDDM) (8-byte character variable) 
For a list of the possible values, see the description of the device-token 
parameter under DSOPEN. 


procopt-count (4-byte binary integer variable) 
Specifies the number of elements in procopt-list. You can specify 0 to indicate 
that procopt-list is empty and is not to be returned. 


procopt-list (returned by GDDM) (array of 4-byte binary integer variables) 
The processing option groups that are applicable to the particular device’s 
family. Each option group consists of a number of 4-byte binary integers, the 
first of which is a code identifying the particular option. Details of processing 
option groups, and the families to which they apply, can be found under 
DSOPEN. 


name-count (4-byte binary integer) 
Specifies the number of 10-byte elements in name-list. 0 can be specified to 
indicate that name-list is empty and is not to be returned. 


name-list (returned by GDDM) (array of 10-byte character strings) 
The device description name by which the device is known to the OS/400 
program. On the AS/400 system, only zero through two elements are valid in 
the array. Again, see the description under DSOPEN for the meaning of these 
tokens for various device families. 


char-count (4-byte binary integer) 
The number of elements in char-list (must be 0 through 15). You can specify 0 
to indicate that char-list is empty and is not to be returned. 
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char-list (returned by GDDM) (array of 4-byte binary integer variables) 
Contains the following information: 


1. 


Device family: 


1 Graphics work station, IBM plotters, graphics-capable printers, or the 
dummy device support provided by device token L79A3. 


. Device input/output capability: 


1 Dummy device 
2 Device supports input and output 
3 Device supports output only 


. Page depth: 


The maximum number of rows usable for a page created in an application 
or the page depth of the default page. 


. Page width: 


The maximum number of columns usable for a page created in an 
application or the page width of the default page. 


. Character box depth: 


The number of pixels in the vertical dimension of each character box in the 
default image symbol set associated with the device. For plotters and 
IPDS printers (which have no default image symbol set), this number 
represents the number of pixels per row. 


. Character-box width: 


The number of pixels in the horizontal dimension of each character box in 
the default image symbol set associated with the device. For plotters and 
IPDS printers (which have no default image symbol set), this number 
represents the number of pixels per column. 


. Vertical resolution: 


The number of pixels in the vertical dimension per meter. 


. Horizontal resolution: 


The number of pixels in the horizontal dimension per meter. For all printers 
except IPDS, this value varies with the characters-per-inch value held in the 
current printer file. At 15 cpi, the pixels per meter are more dense than 
they are at 10 cpi. 


For IPDS printers, the horizontal resolution is independent of the CPI value 
of the print file. 


. Reserved: 0 
. Reserved: 0 
. Reserved: 0 
. Number of colors that can be drawn at one time 
. Reserved: 0 
. Reserved: 0 


. Reserved: 0 
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Coding Example 


In the following example, the program queries device 2: 


OPTION BASE 1 

INTEGER PROCOPT LIST,CHAR_LIST 

DIM PROCOPT LIST(9) 

DIM NAME_LIST$(1)*10 

DIM CHAR_LIST(15) 

CALL GDDM('DSQDEV',2,DEVTOK$,9,PROCOPT LIST(),1, 
NAME_LIST$(),12,CHAR_LIST()) 


Differences between the System/370 Computer and the AS/400 
System 

On the AS/400 system, the name-list character strings are 10 bytes long instead of 
8 bytes. 


New procopt-list option group codes are supported for plotters. 
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DSQUID 


DSQUID-Query Unique Device-ID 


DSQUID(unique-device-id) 


Returns a unique unused device-id. This call can be used by a modular application 
program to obtain an identifier for a new device, without conflicting with a device 
that has already been opened by another part of the application. The device-id 
returned is the highest available unused number. 


Parameters 
unique-device-id (returned by GDDM) (4-byte binary integer variable) 
A device identifier for which no device currently exists. 


Coding Example 
In the following example, GDDM returns an unused device identifier in variable 
DEVID: 


INTEGER DEVID 
CALL GDDM('DSQUID' ,DEVID) 
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DSQUSE 


DSQUSE-Query Device Usage 


DSQUSE(usage,device-id) 


Returns the identifier of the device currently operating with the specified usage. 


Parameters 

usage (4-byte binary integer) 
Must be a valid usage code as described in the DSUSE routine description. 
GDDM returns (in the device-id parameter) the device identifier of the device 
currently having this usage. On the AS/400 system, the value returned is 
always 1. 


device-id (returned by GDDM) (4-byte binary integer variable) 
The device identifier of the device currently operating with the usage specified 
on the usage parameter. If no device is using the specified usage, a value of 
—1 is returned. 


Coding Example 
In the following example, GDDM returns the currently used device identifier in 
variable DEVID: 


INTEGER DEVID 
CALL GDDM('DSQUSE',1,DEVID) 


2-24 AS/400 GDDM Reference 


DSRNIT 


DSRNIT-Reinitialize Device 


DSRNIT(device-id,option) 


Restores the status of a device to the status it had just after it was first explicitly 
opened. DSRNIT frees all resources (Such as page contents, symbol sets, and 
color tables) that have been defined for the device. This is the same as doing a 
DSCLS followed by a DSOPEN. 


Any usage currently in force for this device is discontinued. 


Note that DSRNIT differs from most GDDM routines because it attempts to 
complete even if an error is returned. 


On display devices, the graphics are erased when DSRNIT is called. 


Parameters 
device-id (4-byte binary integer) 
The identifier of the device to be reinitialized. 


option (4-byte binary integer) 
Specifies an action to be carried out when the device is reinitialized. It must 
have the following value: 


0 Erase screen. 


Coding Example 
In the following example, the application program reinitializes the device identified 
as 2: 


(graphics processing that opens a device with identifier 2) 


CALL GDDM('DSRNIT',2,0) 


Differences between the System/370 Computer and the AS/400 
System 

On the AS/400 system, the graphics are always erased; you cannot specify an 
option to keep the graphics on the screen. 
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DSUSE 


DSUSE-Specify Device Usage 


DSUSE(usage,device-id) 


Activates a device that has been opened, and specifies which usage the application 
can make of the device. The device activated becomes the one used by 
subsequent graphics calls. For example, the current primary device is the one 
within which a page would be created if an FSPCRT call were issued. 


The following rules apply to DSUSE: 
1. The device must already be open (DSOPEN routine). 


2. There must be no other device currently operating with the specified usage; if 
there is, an error message is issued unless DSDROP is used to drop one of 
the devices. 


Note that, when a routine is called that requires a device to be in use, but none is 
in use, GDDM issues an internal DSUSE against the default primary device. 


Parameters 
usage (4-byte binary integer) 
The device usage code. The following value is valid: 


1 Current primary device. 


device-id (4-byte binary integer) 
The device identifier of the device concerned. 


Coding Example 

In the following example, the program first uses device 2 as the primary device, 
then drops the use of device 2 as primary device and starts using device 3 as the 
current primary device. 


CALL GDDM('DSUSE',1,2) 
. (graphics processing) 


CALL GDDM('DSDROP',1,2) 
CALL GDDM('DSUSE',1,3) 


Differences between the System/370 Computer and the AS/400 


System 
On the AS/400 system, secondary device support is not provided (usage is 2). 
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FSALRM 


FSALRM-Sound Device Alarm 


FSALRM 


Sounds the work station alarm at the next call to ASREAD or FSFRCE. 


FSALRM is ignored for devices that do not have alarms (such as plotters). 


Parameters 
None 


Coding Example 

In the following example, the program detects an unusual situation, such as an 
overstock of parts in inventory, then constructs an appropriate display (or constructs 
a warning to include in the display). The FSFRCE causes the alarm to be 
sounded, if the device has an alarm. 


(program detects unusual situation) 
CALL GDDM('FSALRM') 
(program constructs appropriate display, as required) 


CALL GDDM('FSFRCE') 


Chapter 2. GDDM Routines 2-27 


FSEXIT 


FSEXIT-Specify an Error Exit and/or Error Severity 


FSEXIT(user-error-program,severity) 


Specifies an error program that you have created that receives control if, on a 
graphics call, a graphics error of at least the specified severity is encountered. 
(Graphics error messages have message identifiers beginning CPG.) This call can 
also be used to change the severity threshold at which messages are sent to the 
specified program. 


All messages below the specified severity are sent to your job log. Messages at or 
above the specified severity are sent to the user exit program. 


Note: You can use this call to have more messages sent to the low-level 
messages display at your display station (which you display by pressing F7 
from the command entry display). This avoids having to display your job 
log or to set up a user error program to see messages. Specify “SAME or 
“NONE for the user-error-program parameter, and specify a value less than 
40 (such as 20 or 30) for the severity parameter. 


A return from the error program gives control to the statement after the one that 
invoked GDDM. 


The error program is passed a single parameter, a 569-byte error record. 


FSEXIT can be called at any time. Subsequent FSEXIT calls override the error 
program and severity specifications of the previous FSEXIT. 


Parameters 

user-error-program (8-byte character variable) 
The name of the program to receive control. The program must be in the 
library list of the user that calls the graphics application program. 


If you have not changed the error exit program parameter and an error whose 
severity is equal to or greater than the current severity level occurs, the OS/400 
program sends escape message CPF8619 to your graphics application 
program, thus terminating your program with a function check. 


The defaults are reset when you call FSTERM. A user error exit program is not 
given control as the result of errors arising from FSTERM. 


The following special values can be specified for this parameter: 


“NONE — ' No user error exit program is to be used; instead, the default 
error exit program is used. 


“SAME  ' The error exit program is to remain unchanged, allowing only 
the severity parameter to be changed. 
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severity (4-byte binary integer) 
Specifies the minimum severity that causes the user error program to receive 
control. You can specify any value from 0 through 99. Severity values used by 
OS/400 Graphics are: 


00 Noerror 

10 Warning 

20 «~Error 

30 Severe error 

40  Unrecoverable error 


When a severity of zero is specified, the error exit is invoked after each call to 
a GDDM routine, whether or not an error has occurred. In such cases, each 
error record will contain only information about the most recent GDDM CALL 
statement. If you specify a severity of 41 or above, the user error program is 
never invoked. 


When graphics is initialized, the default severity is 40 (unrecoverable error). 
Coding Example 
In the following example, if an error with a severity greater than 40 occurs during 


input processing, the graphics program calls program INERR; if the error occurs 
during output processing, the program calls OUTERR. 


CALL GDDM('FSEXIT', 'INERR ',40) 
(input processing) 
CALL GDDM('FSEXIT', 'OUTERR ',40) 


(output processing) 


Differences between the System/370 Computer and the AS/400 
System 

On the AS/400 system a special value of *NONE is used instead of zero to reset 
the user-error-program parameter. 


On the AS/400 system there is a new value, *SAME. This value changes the 
severity parameter while leaving the user-error-program parameter unchanged. 
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FSFRCE-Display Outstanding Graphics 


FSFRCE 


Performs all outstanding graphics output. Unlike ASREAD, FSFRCE does not wait 
for a response from the work station user when data is sent to a display device. 


Use FSFRCE when you also want to use externally described record formats, 
which you define using DDS. You can use externally described record formats to 
display alphanumeric data with graphics data. You can also use externally 
described record formats to give the work station user control over the actions 
taken by your program after seeing the display. (The work station user does this 
by entering data into input-capable fields or by pressing function keys, both of 
which you allow through DDS.) 


Use ASREAD when you just want to display graphics and wait; any response from 
the work station user (including any F key) is sufficient to continue operations. 


Parameters 
None 


Coding Example 

In the following example, the graphics program calls FSFRCE to display graphics, 
then does a WRITE operation to display an externally described record format. 
The externally described record format (defined in DDS, not shown) contains the 
ALWGRH keyword and allows the work station user to press the function keys 
specified in the record format. 


(graphics processing) 
CALL GDDM('FSFRCE') 
WRITE #1, EXTDESCR 'CUSFLDS', INDIC INDICATOR$: 
READ #1, EXTDESCR 'CUSFLDS', INDIC INDICATOR$: 


(further processing depending on the user response) 
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FSINIT-Initialize Graphics 


FSINIT 


Initializes graphics processing. 
This routine must be the first graphics routine to be executed. 


The initialization process sets graphics variables to their default values. 


Parameters 
None 


Coding Example 


In the following example, the graphics program calls FSINIT to begin graphics 
processing. 


(nongraphics processing) 
CALL GDDM('FSINIT') 


(graphics processing) 
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FSPCLR-Clear the Current Page 


FSPCLR 


Deletes all graphic fields within the current page. Also resets the current color 
table and the current symbol set to the IBM-supplied defaults. 


Parameters 
None 


Coding Example 


The following example shows how to code FSPCLR: 
CALL GDDM('FSPCLR') 
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FSPCRT-Create a Page 


FSPCRT(page-id,depth,width,type) 


Creates a page of the specified size and type. The new page is empty. 


Use FSPCRT to do the following: 
e Draw more than one picture at the same time. 


e Send the same picture to both a display and a plotter (you must put the same 
picture into two pages). 


¢ Reset all attributes, including the graphics field, picture space, viewports, and 
window, to default values. 


The following shows the position of this call in the graphics hierarchy: 


Page FSPCRT 
Graphics field GSFLD 
Picture space GSPS 


Viewport GSVIEW 
Window GSWIN 
Segment GSSEG 


To make a picture smaller, you can also use GSFLD. 


For displays, the page must fit on the screen (its depth and width must not be 
greater than the depth and width of the display screen). 


For plotters, the depth and width parameters are ignored. The entire page is used 
(see processing option group 15, plotter paper size, under DSOPEN). 


If you specify FSPCRT, it must follow the device control routines (such as 
DSOPEN, DSUSE, DSRNIT, and DSQUID). 


By default, the new page is also the one that is currently selected. To select a 
page other than the one most recently created, use FSPSEL. 


lf GSVIEW, GSPS, and GSWIN have not been called, the default values are as 
follows: 


¢ On an IBM personal computer, 5292 Model 2, 5555 Model G01, or 5555 Model 
G02, the depth is 24 and the width is 80. 


¢ On the IBM plotters, the depth is 24 and the width is 80. 


¢ Ona printer, the depth and width of the page are dependent on the forms 
width, overflow line, number, and cpi (characters per inch) value of the printer 
file. For more information, refer to the GDDM Programming book. 
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Parameters 

page-id (4-byte binary integer) 
The page identifier for the new page. It must be greater than zero. Zero is 
reserved for the page identifier of the default page, which is always available. 


depth,width (4-byte binary integers) 
The size of the page, in rows and columns, starting at (1,1) in the upper left 
corner. If either depth or width is zero, the appropriate depth or width 
according to the size of the display screen is used. 


type (4-byte binary integer) 
This parameter is ignored on the AS/400 system, but it must be 0 through 3 for 
compatibility with GDDM on other systems. 


Coding Example 
In the following example, the program creates a page with identifier 1; with depth 
and width of zero, the page is the size of the display screen or plotter page. 


CALL GDDM('FSPCRT',1,0,0,0) 


Differences between the System/370 Computer and the AS/400 
System 
On the AS/400 system, the type parameter is ignored. 
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FSPDEL-—Delete a Page 


FSPDEL(page-id) 


Deletes a page. This also causes any graphic segments associated with the page 
to be deleted. 


If this page was the current page, the default page becomes the new current page. 


The default page (identifier zero) cannot be deleted. 


Parameters 
page-id (4-byte binary integer) 
Identifies the page to be deleted. 


Coding Example 


In the following example, the program deletes the page with identifier 1: 
CALL GDDM('FSPDEL', 1) 
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FSPQRY-Query Specified Page 


FSPQRY(page-id,depth,width,type) 


Returns the depth, width, and type of the specified page. If you have not used 
FSPCRT, the depth, width, and type of the default page (created by GDDM) are 
returned. 


Parameters 
page-id (4-byte binary integer) 
Identifies the page about which information is required. 


depth,width (returned by GDDM) (4-byte binary integer variables) 
The dimensions of the page. The depth parameter gives the number of rows; 
the width parameter gives the number of columns. 


type (returned by GDDM) (4-byte binary integer variable) 
The page type as defined for FSPCRT. On the AS/400 system, GDDM always 
returns a value of zero. 


Coding Example 
In the following example, the program requests the depth, width, and type of 
page 2: 

INTEGER DEPTH,WIDTH, TYP 

CALL GDDM('FSPQRY',2,DEPTH,WIDTH, TYP) 


If the page is using the full display screen on a graphics work station, DEPTH is 24, 
WIDTH is 80, and TYP is undefined after the call completes. 


Differences between the System/370 Computer and the AS/400 
System 

On the AS/400 system, the type parameter is ignored, and GDDM returns a value 
of zero. 
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FSPSEL 


FSPSEL-Select a Page 


FSPSEL(page-id) 


Selects a page and makes it the current one. This has two effects: 


e When the device is updated (through the use of ASREAD or FSFRCE), only 
the current page is displayed. 
e Any subsequent graphics field creation or reference is associated with this 
page. 
Only one page can be selected at any time, and the specified page remains 


selected until it is deleted, or until another page is explicitly selected, or until a new 
page is created. 


Parameters 

page-id (4-byte binary integer) 
Identifies the page to be selected. A page-id of zero causes the default page 
to be selected. 


Coding Example 
In the following example, the program first selects page 2, then selects the default 
page: 

CALL GDDM('FSPSEL',2) 


CALL GDDM('FSPSEL',@) 
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FSQCPG 


FSQCPG-—Query Current Page-ID 


FSQCPG(page-id) 


Returns the page-id of the current page. 


Parameters 
page-id (returned by GDDM) (4-byte binary integer variable) 
The identifier of the current page. 


Coding Example 


In the following example, the program queries GDDM for the page-id of the current 
page: 

INTEGER PAGEID 

CALL GDDM('FSQCPG', PAGEID) 
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FSQDEV 


FSQDEV-Query Device Characteristics 


FSQDEV(count,array) 


Returns the characteristics of the current primary device. 


Parameters 

count (4-byte binary integer) 
The number of elements in the array parameter. If you specify fewer elements 
than are required, information about the remaining attributes is not returned. If 
you specify more elements than are returned by GDDM, the excess elements in 
your array are not changed. 


Note that this routine returns the characteristics of the current primary device. 
The DSQDEV call (described earlier) can be used instead, either to determine 
additional information about this device, or to determine information about a 
device that is not the current primary device. 


array (returned by GDDM) (array of 4-byte binary integer variables) 


Refer to the DSQDEV routine for a description of the values that can be returned. 


Coding Example 

In the following example, the program queries GDDM for the first two 
characteristics of the current primary device (family and input/output capability). 
With count equals 2, only two characteristics are returned. The program then tests 
the value of the second element in array DEVCHAR and performs the appropriate 
subroutine (DUMMY if the device is a dummy device; DISP if the device is 
input/output capable; PLOT if device is output only). 


OPTION BASE 1 

INTEGER DEVCHAR 

DIM DEVCHAR(2) 

CALL GDDM('FSQDEV',2,DEVCHAR()) 

IF DEVCHAR(2) = 1 THEN GOSUB DUMMY 
IF DEVCHAR(2) = 2 THEN GOSUB DISP 
IF DEVCHAR(2) = 3 THEN GOSUB PLOT 
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FSQERR-Query Last Error 


FSQERRi(length,error-record) 


Returns information about the last graphics error, that is, the last graphics call that 
resulted in a message with a severity other than zero. Only messages with CPG in 
the message identifier are queried. If no error has occurred since initialization, or 
since the last call to FSQERR, a dummy result is returned (in the error record 
returned by GDDM, character fields are all blanks and numeric fields are all zeros). 


Parameters 

length (4-byte binary integer) 
The length in bytes of storage provided to receive the error data. The number 
of bytes of information provided is that specified in the length parameter, or 
564, whichever is smaller. 


error-record (returned by GDDM) (character variable) 
The data describing the error. For a description of the structure of the error 
record, refer to the GDDM Programming book. 


Coding Example 
In the following example, the program requests information about the most recent 
error: 


OPTION BASE 1 
DIM ERROR$*255 
CALL GDDM('FSQERR',255,ERROR$) 


In BASIC, the maximum length of a character string is 255. Therefore, you cannot 
retrieve all the data supplied by GDDM. However, most of the useful data is in the 
first 100 bytes returned. Therefore, this string length is large enough for most 
purposes. 


Differences between the System/370 Computer and the AS/400 
System 
The format and length of the error record are different on the two systems. 
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FSQUPG 


FSQUPG—Query Unique Page-ID 


FSQUPG(page-id) 


Returns a unique unused page-id. This call can be used by a modular application 
program to obtain an identifier for a new page. The page-id returned is the highest 
available unused number that does not conflict with a page already created by 
another part of the application program. 


Parameters 
page-id (returned by GDDM) (4-byte binary integer variable) 
An identifier for which no page currently exists. 


Coding Example 
In the following example, the program requests a unique page-id: 


INTEGER PAGEID 
CALL GDDM('FSQUPG' , PAGEID) 
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FSREST-Retransmit Data 


FSREST(code) 


Causes all retained data (data included in segments defined with GSSEG) in the 
current page to be sent to the device again the next time your program calls 
FSFRCE or ASREAD. 


Note: This also occurs when an operation against a page or segment is 
performed (such as create or delete) even if FSREST has not been called 
since the last call to FSFRCE or ASREAD. Use FSREST to make sure that 
all retained data in the current page is sent to the device on the next 
FSFRCE or ASREAD. 


Parameters 
code (4-byte binary integer) 
Must be 0 (data only). 


Coding Example 


The following example shows how to use FSREST: 
CALL GDDM('FSREST',0) 


Differences between the System/370 Computer and the AS/400 


System 
On the AS/400 system, the code parameter may not be set to values other than 0. 
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FSRNIT 


FSRNIT-Reinitialize Graphics 


FSRNIT 


Reinitializes GDDM. This function is equivalent to FSTERM followed by FSINIT, 
except that GDDM retains information about the current device, for example, the 
device currently selected for use by DSUSE. 


FSRNIT does not reinitialize Presentation Graphics routines. If you are using 
Presentation Graphics routines, terminate them with CHTERM before using 
FSRNIT. (Issuing a call to FSRNIT before CHTERM produces unpredictable 
results.) 


Use FSRNIT as an alternative to FSTERM and FSINIT, when you want to restart 
GDDM with no memory of any previously defined graphics resources such as 
symbol sets, pages, or color tables, but the same current device is to remain open. 


FSRNIT causes an internal DSRNIT call to be issued against the current device 
(whether explicitly opened, or opened by default), and an internal DSCLS call to be 
issued against any other open devices. 


After FSRNIT, the device that had been in use as the current device remains open 
(no DSOPEN is necessary) but is no longer in use (see DSRNIT). Before it can be 
used, it must again be made the current device using DSUSE (although, as always, 
an implicit DSUSE will be issued against the default primary device if necessary). 

Other devices will need to be reopened using DSOPEN before they can be reused. 


Parameters 
None 


Coding Example 


The following example shows how to use FSRNIT: 
CALL GDDM('FSRNIT') 
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FSTERM 


FSTERM-Terminate Graphics 


FSTERM 


Terminates graphics processing for the application program and frees all the 
resources (Such as symbol sets, pages, and color tables) acquired. 


To do the necessary housekeeping, this routine must be the last graphics routine 
executed in a program. 


Parameters 
None 


Coding Example 
The following example shows how to specify FSTERM: 


CALL GDDM('FSTERM') 


2-44 AS/400 GDDM Reference 


GSARC 


GSARC-Draw a Circular Arc 


GSARC(xc,yc, angle) 


Draws a circular arc about the specified center point, starting at the current 
position. You must specify a picture space with a width-to-height ratio of one to 
one for the arc to appear circular on the graphics work station. The angle 
parameter specifies in degrees how much of the arc to draw. When the angle is 
positive, the arc is drawn counterclockwise from the current position; when 
negative, the arc is drawn clockwise. 


Note that the direction of the arc is determined in world coordinate space, assuming 
the x axis runs left to right and the y axis runs from bottom to top. The direction 
might appear to be reversed on the display surface if the lower window limit is 
larger than the upper limit on either axis. 


The color, line width, and line type of the arc are given by the current values of 
these attributes. 


After the arc is drawn the current position is set to the end of the arc. 


Parameters 
xc,yc (short floating-point numbers) 
Specify the coordinates of the center as an absolute point in world coordinates. 


angle (short floating-point number) 
The angle used by the arc in degrees. When the angle is positive, the arc is 
drawn counterclockwise; when it is negative, the arc is drawn clockwise. 


Coding Examples 


Example 1: 


The following example shows how to draw a complete circle (outline only) with the 
center at x is 50 and y is 50: 


! The following sets the aspect ratio of the picture space to 1:1 
CALL GDDM('GSPS', 1.0, 1.0) 

! Move current position 

CALL GDDM('GSMOVE', 20.0, 20.0) 

! The following draws the circle 

CALL GDDM('GSARC', 50.0, 50.0, 360.0) 
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Example 2: 


The following example shows how to draw a complete circle (the outline, filled with 
a pattern) with the center at x is 50 and y is 50: 


! Set the aspect ratio of the picture space 

CALL GDDM('GSPS', 1.0, 1.0) 

! Move current position 

CALL GDDM('GSMOVE', 20.0, 20.0) 

! Start an area that will be filled with a pattern 
CALL GDDM('GSAREA', 1) 

! Draw the circle 

CALL GDDM('GSARC', 50.0, 50.0, 360.0) 

CALL GDDM('GSENDA') 


The pattern appears because the program calls GSAREA and GSENDA, and the 
outline appears because the parameter on GSAREA has a value of one. 
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GSAREA-Start a Shaded Area 


GSAREA(boundary-control) 


Begins the construction of a shaded area. The construction is ended by GSENDA 
(see “GSENDA—End a Shaded Area” on page 2-76). 


The only drawing routines that can be used between GSAREA and GSENDA are: 


GSARC 
GSELPS 
GSPFLT 
GSLINE 
GSLT 
GSLW 
GSCOL 
GSMIX 
GSMOVE 
GSPLNE 
GSVECM 


The area boundary consists of one or more closed figures, which you construct by 
calling GSARC, GSLINE, GSPLNE, GSELPS, GSPFLT, or an element of GSVECM 
having a control value of 1. You can intersperse calls to GSLT, GSLW, GSCOL, 
and GSMIX among the other calls to change line attributes while you construct the 
figure. 


The starting point of each closed area is the current position when GSAREA is 
called, or as specified by a subsequent call to GSMOVE. GDDM closes the area if 
you specify a call to GSMOVE, to an element of GSVECM with a control value of 
zero, or to GSENDA. The end point of the figure is the current position resulting 
from the last line or arc drawn. 


Each figure should be closed; that is, the starting point and end point should be 
identical. If this is not the case, GDDM closes the figure arbitrarily, by a straight 
line connecting the start and end points. 


The figures formed in this way jointly define the area boundary. Any enclosed area 
is shaded (with the current pattern and color when the GSAREA call is made) if an 
odd number of boundary lines must be crossed to leave the area. If an even 
number of boundary lines must be crossed to leave an area, the area is not 
shaded. 


If the boundary control parameter of the GSAREA call is zero, the actual boundary 
lines are not drawn, but the shading ends at the boundaries. If the boundary 
control parameter is 1, boundary lines and any lines added to close figures are 
drawn. 


The current position is not changed by the GSAREA command, but can be 
changed by the moves and lines between GSAREA and GSENDA, including any 
used to close figures. 


Area definitions cannot be nested. 
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Parameters 
boundary-control (4-byte binary integer) 
Specifies whether or not the boundary lines are to be drawn: 


0 Do not draw boundary lines 
1 Draw boundary lines 


Coding Examples 
Example 1: 


The following example shows how to draw a shaded area with an outline: 


CALL GDDM('GSAREA',1) 

CALL GDDM('GSLINE',12.0,40.0) 
CALL GDDM('GSLINE',12.0,0.0) 
CALL GDDM('GSENDA') 


RV2F719-0 
The bottom line in Example 1 is drawn implicitly by graphics when the GSENDA 
call is completed. 


Example 2: 


The following example shows how to draw a shaded area without an outline: 


CALL GDDM('GSAREA',0) 

CALL GDDM('GSLINE',12.0,40.0) 
CALL GDDM('GSLINE',12.0,0.0) 
CALL GDDM('GSENDA') 
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N 
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Example 3: 


The following example shows how to draw a complete circle (the outline, filled with 
a pattern) with the center at x is 50 and y is 12: 


! Move current position away from corner of picture space 
CALL GDDM('GSMOVE',50.0,0.0) 

! Start area fill 

CALL GDDM('GSAREA', 1) 

! Draw the circle 

CALL GDDM('GSARC', 50.0, 12.0, 360.0) 

! End area fill 

CALL GSENDA 


The pattern appears because the program calls GSAREA and GSENDA, and the 
outline appears because 1 is specified as the boundary-control parameter. The 
pattern shown is pattern 11. 


RV2F721-0 
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GSCA-Set Current Character Angle 


GSCA(dx,dy) 


Specifies the angle of the baseline along which characters in subsequent graphics 
text are written. 


This is valid only in character-mode 2 or 3 (see “GSCM-—Set Current Character 
Mode” on page 2-66). GSCA affects mode 2 and mode 3 characters differently. In 
mode 2, characters are not rotated to lie along the baseline; in mode 3, they are 
rotated to lie along the baseline. See Examples 1 and 2 later in this function 
description. 


Parameters 
dx,dy (short floating-point numbers) 
Define the angle of the baseline with the horizontal. 


The dx and dy parameters have the following effects: 


e When dx equals 0 and dy equals 1 (default), the baseline is vertical. 


e When dx is greater than 0 and dy is greater than 0 the baseline rises to the 
right. The baseline is between 0° and 90° to the baseline. For example, if 
dx and dy are equal, the angle is 45°. 


e When dx is less than 0 and dy is greater than 0 the baseline rises to the 
left. The baseline is between 90° and 180° to the baseline. 


e When dx is greater than 0 and dy is less than 0 the baseline declines to 
the right. 


e When dx is less than 0 and dy is less than 0 the baseline declines to the 
left. 


For a baseline at angle A, dx is cos(A) and dy is sin(A). 


Coding Example 


Example 1: 


The following example shows how GSCA affects mode 2 characters: 


! Set character mode to 2 
CALL GDDM('GSCM' ,2) 


! Set baseline angle to 45 degrees 
CALL GDDM('GSCA',1.0,1.0) 

! Draw character string 'ABCDE' 

CALL GDDM('GSCHAR',50.0,50.0,5, 'ABCDE') 


The following shows how the string appears after using GSCA: 


oe 


RV2F722-0 
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Example 2: 


The following example shows how GSCA affects mode 3 characters: 


! Set character mode to 3 
CALL GDDM('GSCM',3) 


! Set baseline angle to 45 degrees 
CALL GDDM('GSCA',1.0,1.0) 

! Draw character string 'ABCDE' 

CALL GDDM('GSCHAR',50.0,50.0,5, 'ABCDE') 


The following shows how the string appears after using GSCA: 


‘ 
S 
ow 


RV2F723-0 
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GSCB-Set Current Character Box Size 


GSCB (width, height) 


Sets the width and height of the character box for subsequent characters. The 
width parameter sets the spacing between characters along the line of writing 
(which is defined by GSCA). The height parameter sets the spacing between 
consecutive lines of characters. GSCB has the following effects: 


e For mode 2 characters (see “GSCM-—Set Current Character Mode” on 


page 2-66), GSCB has the following effects: 


— On the display, GSCB changes only the spacing of the characters, not the 
size of the characters. 


— On the plotter, the width and height parameters set the size (and the 
aspect ratio) of the characters themselves. Each character fills one 
character box. 


e For the 4214, 4234-2, 5224, and 5225 printers, GSCB changes only the 


spacing of the characters, not the size of the characters. 


For IPDS printers, GSCB changes the spacing of the characters and also 
adjusts the character size within the character box in integer multiples of the 
standard size character. 


For mode 3 characters (see “GSCM-—Set Current Character Mode” on 

page 2-66), the width and height parameters set the size (and the aspect ratio) 
of the characters themselves. Each character fills one character box. See 
Example 2 on page 2-54. 


Parameters 
width,height (short floating-point numbers) 


The width and height of the character box in world coordinate units. 


Both the width and height must be positive. The width determines the size 
and/or spacing of consecutive characters along the line of writing. The height 
determines the spacing of consecutive lines. 


If GSVIEW, GSPS, and GSWIN have not been called, the default values are as 
follows: 


Device Default Default height 
width 

Graphics work station 1.250 4.166 

6180/7371/7372 plotter 1.200 2.833 

Printers 0.757 1.111 
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Example 1: 


The following example shows how GSCB affects mode 2 characters: 


! Set character mode to 2 
CALL GDDM('GSCM' ,2) 


! Set width and height of character box to 10 world 
coordinate units each: 
CALL GDDM('GSCB',10.0,10.0) 


! Draw character string 'ABCDE' 
CALL GDDM('GSCHAR',50.0,50.0,5, 'ABCDE') 


The following shows how the string would appear before using GSCB: 


ABCDE 


RV2F724-0 
The following shows how the string would appear after using GSCB: 


On the display: 
A B C D E 


RV2F725-0 
On the plotter: 


SBC UE 


RV2F726-0 
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Example 2: 


The following example shows how GSCB affects mode 3 characters: 


! Set character mode to 3 
CALL GDDM('GSCM',3) 


! Set width and height of character box to world 
coordinate units each: 
CALL GDDM('GSCB',10.0,10.0) 


! Draw character string 'ABCDE' 
CALL GDDM('GSCHAR',50.0,50.0,5, 'ABCDE') 


The following shows how the string would appear before using GSCB: 


ABCDE 


RV2F727-0 
The following shows how the string would appear after using GSCB: 


AB 2 


RV2F728-0 


2-54  AS/400 GDDM Reference 


GSCD 


GSCD-Set Current Character Direction 


GSCD(character-direction-code) 


Specifies the direction in which the characters in a string are to be drawn, relative 
to the baseline specified by GSCA. 


This is valid only in character mode 2 or 3 (see “GSCM-—Set Current Character 
Mode” on page 2-66). 


Parameters 
character-direction-code (4-byte binary integer) 
Can have one of the following values: 


0 
{ 


The default; same as 1. 

Character boxes (defined by GSCB) are arranged parallel to, and directed 
along, the baseline. New-line direction is 90° clockwise from the baseline. 
This is the normal convention for roman text. 

Character boxes are arranged in columns directed 90° clockwise from the 
baseline. New-column direction is the reverse of the baseline direction. 
This option can be used for drawing roman text vertically (a y-axis title on 
a graph, for example). 

Character boxes are arranged parallel to, but in the reverse of the 
baseline direction. New-line direction is 90° clockwise from the baseline. 
Character boxes are arranged in columns directed 90° counterclockwise 
from the baseline. New-column direction is the reverse of the baseline 
direction. 


Coding Example 
The following example shows how to use GSCD: 


! Set character mode to 3 
CALL GDDM('GSCM',3) 


! Set direction to 2 (90° clockwise from the baseline) 
CALL GDDM('GSCD',2) 


! Draw character string 'ABCDE' 
CALL GDDM('GSCHAR',50.0,50.0,5, 'ABCDE') 


The following shows how the string would appear before using GSCD: 


ABCDE 
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The following shows how the string would appear after using GSCD: 


m™U0UOW LY 
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GSCH-Set Current Character Shear 


GSCH(dx,dy) 


Shears mode 3 characters to an angle defined by the dx and dy parameters. This 
causes upright lines in the characters to be inclined to the angle, as if the 
characters were italic. Horizontal lines in the characters remain horizontal to the 
baseline. The dx and dy parameters define the angle of the upright character 
strokes with the baseline. 


For mode-2 characters, character shear (GSCH) has no effect except when the 
new-line character (X'15') is used in a character string, in which case the starting 
point of the new line is along the line of shear (not necessarily perpendicular to the 
baseline). See Example 2 on page 2-59. 


Parameters 
dx,dy (short floating-point numbers) 
Define the angle to which the characters are sheared, as follows: 


e When dx equals 0 and dy equals 1 (default), normal upright characters 
result. Upright lines in the characters are 90° to the baseline. 


e When dx is greater than 0 and dy is greater than 0 the characters slope 
forwards. Upright lines in the characters are between 0° and 90° to the 
baseline. For example, if dx and dy are equal, the angle is 45°. 


e When dx is less than 0 and dy is greater than 0 the characters slope 
backwards. Upright lines in the characters are between 90° and 180° to 
the baseline. 


e When dy is less than 0 the characters are inverted. 


The following shows how the parameter values define the angle of shear. 


At Right Angles 
to Baseline 


dx 


Character Baseline 


RV2F731-0 
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Coding Examples 
Example 1: 


The following example shows how GSCH affects mode 2 characters: 


! Set character mode to 2 
CALL GDDM('GSCM' ,2) 


! Set character shear slope forwards 
CALL GDDM('GSCH',1.0,2.0) 


! Set up character string 'ABCDEFGHIJ' with new-line character 
! after the E 

DIM STRING$*11 

NEWLINE$ = HEX$('15') 

STRING$ = 'ABCDE'&NEWLINE$&!FGHIJ' 

CALL GDDM('GSCHAR',50.0,50.0,11,STRING$) 


The following shows how the string would appear before using GSCH: 


ABCDE 
FGHIJ 


The following shows how the string would appear after using GSCH: 


ABCDE 
FGHIJ 
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Example 2: 


The following example shows how GSCH affects mode-3 characters: 


! Set character mode to 3 
CALL GDDM('GSCM',3) 


! Set character shear slope forwards 
CALL GDDM('GSCH',1.0,2.0) 


! Draw character string 'ABCDE' 
CALL GDDM('GSCHAR',50.0,50.0,5, 'ABCDE') 


The following shows how the string would appear before using GSCH: 


ABCDE 


RV2F734-0 
The following shows how the string would appear after using GSCH: 


ABCDE 


RV2F735-0 
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GSCHAP-Draw a Character String at Current Position 


GSCHAP (length, string) 


Draws a character string in the graphics field starting at the current position. Also 
allows a character string to be appended to a previous one. Each character in the 
string is drawn with its lower left corner at the current position, and the current 
position is then advanced to the starting position of the next character. After using 
GSCHAP, the current position is at the end of the string. For an overview of 
attribute settings that affect character strings, see “GSCM—Set Current Character 
Mode” on page 2-66. 


Parameters 
length (4-byte binary integer) 
The number of characters in the string parameter. 


string (character string) 
The character string to be drawn. Control and undefined values are reserved 
and should not be used, except for X'15', which is interpreted as a new-line 
character. See Example 2 on page 2-61. Each new-line character in the string 
sets the current position one character box height (set by GSCB) below the 
start of the string. Below is strictly defined by a line whose direction is 90° 
clockwise from the character baseline (set by GSCA). For an easy way to 
control the direction a string reads, see “GSCD-—Set Current Character 
Direction” on page 2-55. 


Hex FF has a reserved meaning and should not be used. 


In BASIC, you cannot directly specify how to set bits on and off but you can 
use the HEX$ built-in function. In RPG III, you could use the BITON and 
BITOFF operation codes; in PL/I, you could use BIT data; in the COBOL/400 
language, there is no direct way of manipulating bit strings; you might want to 
call a program in another language, passing a character string to another 
program to initialize and return with the correct bit values. 
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Coding Examples 

Example 1: 

The following example shows how to use GSCHAP: 
CALL GDDM('GSCHAP',23,'Sample Character String') 

Example 2: 


The following example shows how the new-line character affects character strings: 


DIM STRING$*11 

! Set up character string 'ABCDEFGHIJ' with new-line character 
! after the E 

NEWLINE$ = HEX$('15') 

STRING$ = 'ABCDE'&NEWLINE$&!FGHIJ' 

CALL GDDM('GSCHAP',11,STRING$) 


The following shows how the string would appear at the current position: 


ABCDE 
FGHIJ 
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GSCHAR-Draw a Character String at a Specified Point 


GSCHAR(x,y, length, string) 


Draws a character string starting at the specified point. 


GSCHAR(x,y,length, string) is equivalent to: 


GSMOVE(x,y) 
GSCHAP (length, string) 


Each character in the string is drawn with its lower left corner at the current 
position, and the current position is then advanced to the starting position of the 
next character. For an overview of attribute settings that affect character strings, 
see “GSCM-—Set Current Character Mode” on page 2-66. 


After the string is drawn, the new current position is the point at which the next 
character after the end of the string would be drawn. To find out the new current 
position, use GSQCP. 


If clipping is enabled, any part of any character that is outside the window is 
removed. Also, for mode-2 characters, the entire character is clipped if any part of 
the character box is outside the window. 


When clipping is disabled, and any part of the string is outside the window, the 
result is undefined. 


Parameters 
x,y (short floating-point numbers) 
The starting position of the string in world coordinates. 


length (4-byte binary integer) 
The number of characters in the string supplied. 


string (character string) 
The character string to be drawn, as described for GSCHAP. 
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Coding Examples 
Example 1: 
The following example shows how to use GSCHAR: 
CALL GDDM('GSCHAR',10.0,5.0,23, 'Sample Character String') 
Example 2: 


The following example shows how the new-line character affects character strings: 


DIM STRING$*11 

! Set up character string 'ABCDEFGHIJ' with new-line character 
! after the E 

NEWLINE$ = HEX$('15') 

STRING$ = 'ABCDE' &NEWLINE$&'FGHIJ' 

CALL GDDM('GSCHAR',50.0,50.0,11,STRING$) 


The following shows how the string would appear: 


ABCDE 
FGHIJ 
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GSCLP-Enable and Disable Clipping 


GSCLP(clipping-mode) 


Enables and disables clipping to window boundaries. The setting applies only to 
the current page. 


Clipping should be enabled when there is reference to world coordinates that lie 
outside the window. When clipping is enabled, parts of the picture that fall outside 
the window boundaries (defined by GSWIN) are removed. If a primitive, for 
example a line, falls completely outside the window, it is discarded. If a primitive 
falls partly within and partly outside the window, the primitive is clipped to keep only 
that part within the window. Lines and arcs are shortened so as to stop at the 
window boundary. Markers appear if their center points are within the window. For 
character strings, the result depends on the character mode; see “GSCM-Set 
Current Character Mode” on page 2-66. 


When clipping is disabled, all parts of the drawing should lie within the window. lf 
they do not, the results are undefined. 


Parameters 
clipping-mode (4-byte binary integer) 
Controls the clipping state, as follows: 


0 Clipping disabled (default) 
1 Clipping enabled 


Coding Example 


The following example shows how to use GSCLP: 
CALL GDDM('GSCLP',1) 
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GSCLR-Clear the Graphics Field 


GSCLR 


Clears the graphics field by deleting all of its graphics segments. The effect does 
not appear on the display until the next transmission takes place (that is, on the 
next call to ASREAD or FSFRCE). 


Parameters 
None 


Coding Example 
The following example shows how to use GSCLR: 


CALL GDDM('GSCLR') 
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GSCM-Set Current Character Mode 


GSCM(character-mode) 


Controls the character mode to be used in drawing character strings in the graphics 


field. 


You must use GSCM to set character mode 2 or 3 before using GSCA, GSCB, 
GSCD, or GSCH. You must also use GSCM to set character mode 2 or 3 for a 
GSCS call to take effect. 


Parameters 
character-mode (4-byte binary integer) 
Interpreted as follows: 


0 
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Default; use this code to return to using default hardware characters after 
using another character mode. Character box (GSCB), angle (GSCA), 
shear (GSCH), and direction (GSCD) are ignored. Characters are 
positioned horizontally in adjacent hardware cells. 


Not valid on the AS/400 system. 


Graphics image symbols (defined by matrices of dots). The character set 
must be the standard symbol set 0, or be a graphics image symbol set 
previously loaded by GSLSS. Character angle (GSCA), box (GSCB), 
direction (GSCD), and shear (GSCH) affect only the string, not individual 
characters in the string. Character angle (GSCA) rotates the baseline, 
but individual characters are not rotated to lie along the baseline. 
Character box (GSCB) changes the spacing between characters and 
between lines of characters. 


Note: For IPDS printers, GSCB adjusts the character size within the 
character box in integer multiples of the standard size character. 


Character direction (GSCD) changes the direction in which the string 
reads. Character shear (GSCH) has no effect except when the new-line 
character (hex 15) is used in a character string, in which case the starting 
point of the new line is along the line of shear (not necessarily 
perpendicular to the baseline; see “GSCH-—Set Current Character Shear” 
on page 2-57). When clipping is enabled (see “GSCLP—Enable and 
Disable Clipping” on page 2-64) and any part of a character box is 
outside the window, no part of the character in the box is drawn. 


GSCM 


3 Vector symbols (defined by a series of vectors). The character set must 
be the standard vector set 0, or be a vector symbol set previously loaded 
by GSLSS. Character angle (GSCA), box (GSCB), direction (GSCD), and 
shear (GSCH) affect both the string and individual characters in the string. 
Character angle (GSCA) rotates the baseline and rotates individual 
characters to lie along the baseline. Character box (GSCB) changes the 
spacing between characters and between lines of characters and changes 
the size of the characters. Character direction (GSCD) changes the 
direction in which the string reads. Character shear (GSCH) shears the 
characters at an angle. When clipping is enabled (see GSCLP), any 
portion of a character that is outside the window is truncated. 


Coding Example 


The following example shows how to use GSCM: 
CALL GDDM('GSCM', 3) 


Differences between the System/370 Computer and the AS/400 


System 
On the AS/400 system, character mode 1 is not supported. 
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GSCOL-Set Current Color 


GSCOL(color-index) 


Sets the current value of the color attribute. This attribute value applies to all 
subsequent graphics primitives until it is changed. 


The color attribute value selected may not produce the indicated color if: 


¢ On the display, a color table other than the default has been selected. 


¢ On the plotter, the pens have been loaded in a manner not corresponding to 
the default definitions. 


Parameters 

color-index (4-byte binary integer) 
The color attribute value. For the attribute value definitions, see “Color 
Numbers” on page C-1. 


Coding Example 


The following example shows how to use GSCOL: 
CALL GDDM('GSCOL' ,8) 
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GSCS-Set Current Symbol Set 


GSCS(symbol-set-id) 


Sets the current value of the symbol set attribute. Characters in subsequent 
character strings are drawn from the set specified. 


This is valid only in character mode 2 or 3; see “GSCM-Set Current Character 
Mode” on page 2-66. 


Parameters 
symbol-set-id (4-byte binary integer) 
The symbol set identifier. 


The allowable symbol-set-ids are: 

0 default symbol set 

8 Double-byte character set data (no shift-out or shift-in) 
65 through 223 other symbol sets 


If a symbol-set-id is the same as one issued previously for the same type, the 
new definitions replace the previous ones. 


Coding Example 


The following example shows how to use GSCS: 


! Set character mode to 3 
CALL GDDM('GSCM',3) 


! Load symbol set 
CALL GDDM('GSLSS',2, 'ADMUVDRP' , 65) 


! Set symbol set attribute 
CALL GDDM('GSCS',65) 
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GSCT-Select Color Table 


GSCT(color-table-id) 


Selects a color table for use on the primary device. 


Other than the default color table, a color table must have been defined (using the 
GSCTD routine) before it can be selected. 


When a color table is selected, it is associated with the current page. If a new 
page is subsequently selected, the color table for the new page is the default table. 
The page must be created before the color table is selected. 


Parameters 
color-table-id (4-byte binary integer) 
The color table identifier. 
Zero is reserved for the identifier of the default color table, which is always 


available. The allowable color-table-ids for definable color tables are 65 
through 223. 


Coding Example 


The following example shows how to use GSCT: 
CALL GDDM('GSCT',65) 
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GSCTD-—-Define Color Table 


GSCTD(color-table-id,start-color,count,hue-array,lightness-array, 
saturation-array) 


Defines a color table, including all entries contained in it. 


Each color table has eight entries, corresponding to color attribute values 1 through 
8. The definition of entry number 8, which represents the background color (black 
on displays), is always fixed and cannot be changed. 


The color table does not contain an entry for color attribute value 0. If color 0 is 
selected (with GSCOL) when a user-defined color table is in use, the resulting color 
is that which is defined by color table entry number 4 (which defaults to green on 
displays). This is for compatibility with devices that do not support color tables. 


Any entries not defined contain the default color for the corresponding color 
attribute value. Any definitions for entries beyond entry number 7 are ignored. 


When a color table is defined, it is associated with the current primary device and it 
may be selected for use on a page with the GSCT routine. If the current primary 
device does not support color tables, the call is ignored. When the current primary 
device is closed (DSCLS or DSRNIT), all color table definitions for it are lost. 


Parameters 
color-table-id (4-byte binary integer) 
The identifier by which your program will refer to this color table in later calls. 


The allowable color-table-ids for definable color tables are 65 through 223. 


start-color (4-byte binary integer) 
The number of the entry at which the color table definitions should start. 


The start-color must be in the range 1 through 7. When greater than 1, entries 
up to the start-color will contain default color definitions. 


count (4-byte binary integer) 
The number of color table entries being defined. This number should be equal 
to the number of entries in the hue, lightness, and saturation arrays. 


hue-array (array of short floating-point numbers) 
The hue values for each of the table entries being defined. Values can range 
from 0.00 through 1.00, with 0.00 and 1.00 giving blue, and intermediate values 
giving other hues. 


lightness-array (array of short floating-point numbers) 
The lightness values for each of the table entries being defined. Values range 
from 0.0 through 1.0, with 0.0 giving the least lightness (black), 1.0 indicating 
the most (white), and intermediate values giving varying degrees of lightness 
between the extremes. 


saturation-array (array of short floating-point numbers) 
The saturation values for each of the table entries being defined. Values range 
from 0.0 through 1.0, with 0.0 giving a completely unsaturated color (gray), 1.0 
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giving full saturation, and intermediate values giving varying degrees of partial 
saturation. 


Figure 2-5 shows the default values for graphics work stations. For negative color 


index values or color index values greater than 8, refer to the table shown in the 
GSCOL description. 


Figure 2-5. Default Color Definitions for Graphics Work Stations 
Color | Display Default H (Hue) L (Lightness) S (Saturation) 
Code Color 

1 Blue 0.0 0.5 1.0 
2 Red 0.33 0.5 1.0 
3 Pink 0.16 0.5 1.0 
4 Green 0.66 0.5 1.0 
5 Turquoise 0.83 0.5 1.0 
6 Yellow 0.5 0.5 1.0 
7 Neutral (white) 0.0 1.0 0.0 
8 Background (black) 0.0 0.0 0.0 


Other color definitions that might be useful are: 


Color H (Hue) L (Lightness) S (Saturation) 
Orange 0.4 0.5 1.0 

Gray 0.0 0.5 0.0 

Brown 0.35 0.2 0.75 

Purple 0.16 0.2 1.0 

Rose 0.22 0.38 0.7 

Dark green 0.66 0.2 1.0 

Light green 0.6 0.6 0.8 

Dark blue 0.0 0.2 1.0 

Light blue 0.9 0.7 1.0 
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Coding Example 
The following example shows how to use GSCTD to redefine colors 1 through 3 as 
orange, gray, and brown: 


OPTION BASE 1 
DECIMAL HUE_ARR 

DIM HUE_ARR(3) 

MAT READ HUE_ARR 
DATA 0.4, 0.0, 0.35 
DECIMAL LT_ARR 

DIM LT_ARR(3) 

MAT READ LT_ARR 
DATA 0.5,0.5,0.2 
DECIMAL SAT_ARR 

DIM SAT_ARR(3) 

MAT READ SAT_ARR 
DATA 1.0, 0.0, 0.75 
CALL GDDM('GSCTD',65,1,3,HUE_ARR(),LT ARR(),SAT_ARR()) 


CALL GDDM('GSCT' ,65) 
Differences between the System/370 Computer and the AS/400 


System 
This routine is not supported on the System/370 computer. 
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GSELPS-Draw an Elliptic Arc 


GSELPS(p,qg,tilt-angle,xe,ye) 


Draws a curve that starts at the current position and follows an elliptical curve until 
it reaches the end point. The ellipse has major and minor axis lengths given by p 
and q, and the major axis (p) is inclined to the x axis by the axis tilt angle supplied. 


The arc is considered to be constructed as follows. An ellipse with the given major 
and minor axis lengths is constructed with the major axis lying along the x axis. 
The ellipse is then rotated by the axis tilt angle and moved so that current position 
and the end point both lie on the curve. 


In general, there are two possible positions for the ellipse center. One is to the 
right and one is to the left of the line drawn from the starting point to the end point 
viewed in that direction. If p and q have the same sign, the center point to the left 
of the line is chosen, and the arc is drawn counterclockwise about it. When p and 
q have opposite signs, the arc is drawn clockwise about the center to the right of 
the line. 


The arc drawn is never more than half an ellipse. 


The color, line width, and line type of the arc are given by the current values of 
these attributes. 


The current position is set to the end of the arc. 


Parameters 
p (short floating-point number) 
The major axis length; cannot be zero. 


q (short floating-point number) 
The minor axis length; cannot be zero. 


tilt-angle (short floating-point number) 
The inclination of the major axis to the x axis in degrees (the major axis is that 
with length p, regardless of which axis is the longer). Positive tilt angles result 
in counterclockwise rotation of the ellipse, negative tilt angles result in 
clockwise rotation. 


xe,ye (short floating-point numbers) 
The coordinates of the end point of the arc. 
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Coding Example 
The following example shows how to use GSELPS: 
! The following sets the aspect ratio of the picture space to 1:1 
CALL GDDM('GSPS',1.0,1.0) 
! The following draws the ellipse 
CALL GDDM('GSELPS', 8.0, 4.5, 30.0, 20.0, 5.0) 


This is the sample ellipse: 


MAJOR AXIS 
MINORAXIS —____ (LENGTH =25) 


(LENGTH=15) ——___ 


START-POINT 
(70.35) 
END-POINT CENTER 
(30.25) 
TILTANGLE IS 
45 DEGREES 


RV2F738-0 
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GSENDA-End a Shaded Area 


GSENDA 


Ends the construction of a shaded area. If necessary, a final line is drawn to close 
the area. 


The current position is not changed, unless a final line must be drawn to close the 
figure. In that case, it is moved to the end point of the final line. 


Parameters 
None 


Coding Example 

The following example shows how to use GSENDA: 
CALL GDDM('GSAREA',1) 
CALL GDDM('GSLINE',12.0,40.0) 


CALL GDDM('GSLINE',12.0,0.0) 
CALL GDDM('GSENDA') 


For an illustration of the area drawn, see Example 1 under “GSAREA-Start a 
Shaded Area” on page 2-47. 
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GSFLD-Define the Graphics Field 


GSFLD(row,column,depth,width) 


Explicitly defines the graphics field, which is the area of the current page where the 
picture is drawn. The graphics field is defined in row/column coordinates. 


Only one graphics field is allowed in any one page. 


Use GSFLD to: 


e Make the picture in a page smaller. 

¢ Create a field that can be cleared using GSCLR. 

e Reserve an area on the screen for alphanumeric data (described using data 
description specifications). 


The following shows the position of this call in the graphics hierarchy: 


Page FSPCRT 
Graphics field GSFLD 
Picture space GSPS 


Viewport GSVIEW 
Window GSWIN 
Segment GSSEG 


If the graphics field is redefined (using GSFLD), the existing graphics contents of 
the page are lost, and all segments in the original field are deleted. A new 
graphics field is created in the newly defined area. 


If no graphics field has been created when one is required to perform a requested 
function, one is created automatically. The default graphics field covers the entire 
screen or printed page. 


If the primary device is an IBM plotter, the graphics field always covers the entire 
page regardless of the values specified for the row, column, width, and depth. 
However, those specified values must be valid for a screen on an graphics work 
station. (That is, row plus depth cannot exceed 24, and column plus width cannot 
exceed 80.) 


If the device token is L79A3, the row plus depth cannot exceed 32, and column 
plus width cannot exceed 80. 


For printers, the graphics field cannot exceed the row/column (overflow for rows, 
forms width for columns) specification for the printer file in use. 


Parameters 

row,column (4-byte binary integers) 
The position on the page of the top left corner of the graphics field. If a row or 
column of zero is specified, the graphics field is deleted. 


depth,width (4-byte binary integers) 
The size of the field, in rows and columns. If either the depth or width is zero, 
the graphics field is deleted. 
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Coding Example 


The following example shows how to use GSFLD: 
CALL GDDM('GSFLD',1,1,24,40) 
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GSFLW-—Fractional Line Width 


GSFLW(linewidth-multiplier) 


Sets the current line width as a floating-point value. 


The internal representation of the line width can thus be set to fractional values. 
GDDM draws the widest line that does not exceed the requested line width. If 
there is no line width thin enough, the thinnest available line is drawn. 


The line width attribute does not affect mode-3 characters that are drawn using 
GSCHAP or GSCHAR. These characters are always drawn using the default line 
width. 


Parameters 
linewidth-multiplier (short floating-point number) 
The line width. Can be from 0 (thinnest) through 100 (thickest). 


Line width 1.0 is the standard line width for the device. Line widths greater 
than one give proportionately wider lines. Line widths less than one give 
narrower lines. A line width of zero produces the thinnest line. 


The standard line width in pixels for the current device (see following table) is 
multiplied by the line-width-multiplier, and the result rounded down to an integer 
value. This value defines, in pixels, the width of the lines subsequently drawn. 
If the result is zero, a width of one pixel is used. If the result is more than the 
maximum for the current device, the maximum is used. 


Parameter values are interpreted on devices attached to the AS/400 system like 


this: 
Minimum Standard Maximum 
Device (Value is 0) (Value is 1) (Value is 100) 
5292 Model 2 1 1 2 
IBM PCs 1 1 1 
IBM plotters 1 1 1 
Printers 1 1 2 


Coding Example 
The following example shows how to use GSFLW: 


CALL GDDM('GSFLW',1.5) 
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GSGET-Retrieve Graphics Data 


GSGET (buffer-length,buffer,GDF-length) 


Retrieves graphics data from the current page. When this routine is called, GDDM 
converts graphics data from the page into GDF format (see Appendix B, “GDF 
Order Descriptions”) and returns it in the buffer parameter. 


This call is valid only if a dummy device is being used (for more information on 
dummy devices, see Figure 2-2 on page 2-10). 


The GDF data that results does not necessarily resemble the original commands 
used to generate the picture, as these have been processed to suit the primary 
device in use. For example, coordinates are converted to an internal coordinate 
system with some loss of precision. Complex primitives (such as curved fillets) 
might be simplified and approximated. Clipping might have caused changes to the 
data. The data is thus not the same as the original. However, you can use GDF 
data to store a description of a picture in a form such that you need not make 
individual calls to OS/400 Graphics functions again. 


Color tables cannot be saved as graphics data. 


The first order in the generated GDF data is a GDF comment order (see “Comment 
Order” on page B-17), which contains the following information to allow you to use 
the GDF data later (see GSPUT): 


1. One 2-byte binary integer indicating the coordinate format used in the GDF 
data (see GSPUT). This always takes a value of 2, indicating that the 
coordinates are given as 2-byte binary integers. 


2. One 2-byte binary integer indicating the data type of following fields. If the 
GDF data was generated on the AS/400 system, this field takes a value of 2, 
and the following fields are 2-byte binary integers. If the GDF data was 
generated other than on the AS/400 system, this field can be one of the 
following: 


1 Following fields are 1-byte binary integers (not supported on the AS/400 
system). 


2 Following fields are 2-byte binary integers (the default on the AS/400 
system). 


3 Following fields are 4-byte binary integers (not supported on the AS/400 
system). 


4 Following fields are real (System/370 floating point; not supported on the 
AS/400 system). 


3. Four 2-byte binary integer coordinates giving, in order, the lower and upper x 
bounds and the lower and upper y bounds of the coordinates. (Coordinates 
are only within these limits if clipping was enabled throughout the picture 
generation.) 
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Retrieval of graphic data must start with a call to GSGETS (described later in this 
chapter). This indicates the data that is needed. One or more calls to GSGET can 
then be used to fetch the data. 


If the buffer is long enough to contain the GDF data requested, the data is 
returned, and the last parameter is set to indicate its length. If the buffer is not long 
enough, the buffer is filled, and more data can be obtained by another call to 
GSGET. All data has been extracted when a length of zero is returned (without 
error). 


Each call to GSGET retrieves a number of complete GDF orders. Part of an order 
is never returned. (This means that buffers obtained from GSGET can be returned 
as input to GDDM through GSPUT.) If there is not enough room in the buffer to 
take a complete order, no data is returned, and an error occurs. 


Graphics retrieval must be ended by GSGETE (see “GSGETE-—End Retrieval of 
Graphics Data” on page 2-83). 


Parameters 

buffer-length (4-byte binary integer) 
The length of the buffer. This should exceed 260 bytes to guarantee that 
errors do not occur. 


Note: BASIC does not support character strings longer than 255 bytes. This 
could cause problems for graphics programs for which a large number 
of points are specified for GSPFLT or GSPLNE or for which long 
character strings are specified for GSCHAP or GSCHAR. 


buffer (returned by GDDM) (character) 
A program variable, of stated length, to receive the GDF data. 


GDF-length (returned by GDDM) (4-byte binary integer) 
A 4-byte binary integer variable that GDDM normally sets to the length of GDF 
data placed in the buffer. If it is zero (and no error is reported), all the GDF 
data requested has already been returned. 
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Coding Example 
The following example shows how to use GSGET with its companion calls 
GSGETS and GSGETE: 


OPTION BASE 1 
! Create segment to get retained data 
CALL GDDM('GSSEG',1) 


. (draw graphics) 


CALL GDDM('GSSCLS') 

! Use GSGETS to start GDF retrieval 
INTEGER IDARRAY 

DIM IDARRAY (1) 

LET IDARRAY(1) = 0 

CALL GDDM('GSGETS',1, IDARRAY()) 

! Set up variables for GSGET 
INTEGER GDFLEN 


DIM BUF$*255 ! NOTE: Can't be >255 in BASIC 
! Set up loop to read all graphics data in current segment 
LOOP: 


GSGET (255, BUF$, GDFLEN) 


. (processing to save contents of BUF$ 
elsewhere in program or in a file) 


IF GDFLEN > 0 THEN GOTO LOOP ELSE GOTO ENDGET 
! End retrieval of graphics data 
ENDGET: CALL GDDM('GSGETE') 


Note: Some GDF orders can require more than 255 bytes for the graphics-data 
parameter (in this example, BUF$). These include orders for graphics text 
(GSCHAP and GSCHAR with very long character strings), polyfillets, and 
polylines. If your graphics data includes such orders, you should use 
another language to write the program using GSPUT. 
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GSGETE-End Retrieval of Graphics Data 


GSGETE 


Ends the retrieval of graphics data (see “GSGET-Retrieve Graphics Data” on 
page 2-80 and “GSGETS-Start Retrieval of Graphics Data” on page 2-84). 


This call is valid only when a dummy device is being used. For more information 
on dummy devices, see Figure 2-2 on page 2-10. 


GSGETE can be called whether or not all the graphics data has been retrieved. 


Parameters 
None 


Coding Example 
The following example shows how to use GSGETE with its companion calls 
GSGET and GSGETS: 


OPTION BASE 1 
! Create segment to get retained data 
CALL GDDM('GSSEG',1) 


. (draw graphics) 


CALL GDDM('GSSCLS') 

! Use GSGETS to start GDF retrieval 
INTEGER IDARRAY 

DIM IDARRAY (1) 

LET IDARRAY(1) = 0 

CALL GDDM('GSGETS',1, IDARRAY()) 

! Set up variables for GSGET 
INTEGER GDFLEN 


DIM BUF$*255 ! NOTE: Can't be >255 in BASIC 
! Set up loop to read all graphics data in current segment 
LOOP: 


GSGET (255, BUF$, GDFLEN) 


. (processing to save contents of BUF$ 
elsewhere in program or in a file) 


IF GDFLEN > 0 THEN GOTO LOOP ELSE GOTO ENDGET 
! End retrieval of graphics data 
ENDGET: CALL GDDM('GSGETE') 


Note: Some GDF orders can require more than 255 bytes for the graphics-data 
parameter (in this example, BUF$). These include orders for graphics text 
(GSCHAP and GSCHAR with very long character strings), polyfillets, and 
polylines. If your graphics data includes such orders, you should use 
another language to write the program using GSPUT. 
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GSGETS-Start Retrieval of Graphics Data 


GSGETS(count,array) 


Starts the retrieval of graphics data from the current page. 


This call is valid only if a dummy device is being used. For more information on 
dummy devices, see Figure 2-2 on page 2-10. 


You can retrieve the graphics data for an individual named segment or the data for 
all segments in the page. You cannot retrieve temporary data (graphics primitives 
that are not in a segment); therefore all parts of a picture that are to be retrieved 

must be produced by primitives that occur between calls to GSSEG and GSSCLS. 


GSGETS specifies the data required and begins the retrieval. Data is obtained by 
one or more calls to GSGET (described earlier in this chapter), and the retrieval is 
ended by GSGETE. 


Retrieval of graphics data cannot be started when there is an open segment. 


Parameters 
count (4-byte binary integer) 
The number of elements in the following array. This must be zero or one. 


array (array of 4-byte binary integers) 
The array can have at most one element. This is the identifier of the segment 
required. If the identifier is zero or the array has no elements, all segments are 
retrieved. 


Coding Example 
The following example shows how to use GSGETS with its companion calls 
GSGET and GSGETE: 


OPTION BASE 1 
! Create segment to get retained data 
CALL GDDM('GSSEG',1) 


. (draw graphics) 


CALL GDDM('GSSCLS') 

! Use GSGETS to start GDF retrieval 
INTEGER IDARRAY 

DIM IDARRAY (1) 

LET IDARRAY(1) = 0 

CALL GDDM('GSGETS',1, IDARRAY ()) 

! Set up variables for GSGET 
INTEGER GDFLEN 


DIM BUF$*255 ! NOTE: Can't be >255 in BASIC 
! Set up loop to read all graphics data in current segment 
LOOP: 


GSGET (255, BUF$, GDFLEN) 


. (processing to save contents of BUF$ 
elsewhere in program or in a file) 
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IF GDFLEN > 0 THEN GOTO LOOP ELSE GOTO ENDGET 
! End retrieval of graphics data 
ENDGET: CALL GDDM('GSGETE') 


Note: Some GDF orders can require more than 255 bytes for the graphics-data 
parameter (in this example, BUF$). These include orders for graphics text 
(GSCHAP and GSCHAR with very long character strings), polyfillets, and 
polylines. If your graphics data includes such orders, you should use 
another language to write the program using GSPUT. 
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GSIMG-Draw a Graphics Image 


GSIMG(type,width,depth, length, graphics-image-data) 


Draws a graphics image at the current position. All images are drawn within a 
rectangle on the device and consist of an array of PELs. 


The width and depth parameters determine the dimensions of the rectangle in 
PELs. The data-graphics image parameter determines which of the PELs are 
visible. A bit set to one in the data-graphics image parameter sets the associated 
PEL on. A bit set to zero leaves the associated PEL unchanged. 


The top left corner of the graphics image is placed at the current position, and the 
data supplied is drawn row by row starting at the top. Each row is drawn from left 
to right. The number of PELs in each row must be a multiple of 8. You can pad 
the row with zeros when the graphics image width specified is not a multiple of 8. 
If, for example, the graphics image width specified is 12, each row of data must be 
padded out to a length of 16 so that the data occupies 2 bytes exactly. (See 
Example 2 later in this function description.) If this is not done, the graphics image 
is distorted. 


The length parameter must take into account the padding of each row of data. The 
length must be given in bytes (1 byte for each 8 bits in the graphics image); an 
error occurs if the length is incorrect. 


The color of the graphics image is determined by the current value of the color 
attribute. The current position remains unchanged after the graphics image has 
been drawn. 


Parameters 
type (4-byte binary integer) 
The type of the graphics image to be drawn. Must be set to 0. 


width (4-byte binary integer) 
The width of the graphics image in PELs (not including padding with zeros, if 
needed to fill out full bytes). The width parameter must be smaller than 2040 
PELs. 


depth (4-byte binary integer) 
The depth of the graphics image in PELs. 


length (4-byte binary integer) 
The length in bytes of the graphics image data. The length must be the 
product of the width and the depth, divided by eight, or 


(width rounded up to a multiple of 8) x (depth) / 8 = length. 


graphics-image-data (character string) 
The graphics image data to be displayed. The PELs must be given row by 
row, starting at the top and running from left to right within each row. 


In BASIC, you cannot directly specify how to set bits on and off but you can 
use the HEX¢$ built-in function. In RPG Ill, you could use the BITON and 
BITOFF operation codes; in PL/I, you could use BIT data; in Pascal, you could 
use hexadecimal string constants; in the COBOL/400 language, there is no 
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direct way of manipulating bit strings. You might want to call a program in 
another language, passing a character string for the other program to initialize 
and return with the correct bit values. 


For further examples using GSIMG in other languages, see the GDDM 
Programmingbook. 


In BASIC, in the HEX$ built-in function, each number in the apostrophes is 
equivalent to a 4-bit string, as follows: 


Hex digit Bit string 


0000 
0001 
0010 
0011 
0100 
0101 
0110 
0111 
1000 
1001 
1010 
1011 
1100 
1101 
1110 
1111 


T™MmMOOWPOANDURWN=AO 


For example, the first number (8) is equivalent to 1000. The second number 
(1) is equivalent to 0001. Together they fill out 1 byte (8 bits) for the top row of 
the graphics image. 


Coding Examples 


Example 1: 


The following example shows how to use GSIMG: 


OPTION BASE 1 

! Move current position to center of screen 
CALL GDDM('GSMOVE',50.0,50.0) 

! Set up graphics image 

DIM CROSS$*7 

LET CROSS$ = HEX$('81422418244281') 

CALL GDDM('GSIMG',0,8,7,7,CROSS$) 
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This example gives the following output: 


Hex values Bit values Sample output 
81 10000001 
42 01000010 
24 00100100 
18 00011000 x 
24 00100100 
42 01000010 
81 10000001 
RV2F739-0 
Example 2: 


The following example shows how to use GSIMG when the graphics image must 
be padded on the right with zeros: 


OPTION BASE 1 

! Move current position to center of screen 

CALL GDDM('GSMOVE',50.0,50.0) 

! Set up graphics image 

DIM LGCROSS$«22 

LET LGCROSS$ = HEX$('80104020204010800900060009001080204040208010') 
CALL GDDM('GSIMG',0,12,11,22,LGCROSS$) 


This example gives the following output: 


Hex values Bit values Sample output 
8010 1000 0000 0001 0000 

4020 0100 0000 0010 0000 

2040 0010 0000 0100 0000 

1080 0001 0000 1000 0000 

0900 0000 1001 0000 0000 

0600 0000 0110 0000 0000 4 
0900 0000 1001 0000 0000 

1080 0001 0000 1000 0000 

2040 0010 0000 0100 0000 

4020 0100 0000 0010 0000 

8010 1000 0000 0001 0000 


RV2F740-0 
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GSIMGS-Draw Scaled Graphics Image 


GSIMGS(type,width,depth, length, graphics-image-data,x-size,y-size) 


Draws a graphics image in the same way as the GSIMG call but scales the size of 
the graphics image as well. 


The first five parameters are interpreted as the parameters of the GSIMG call. The 
x- and y-size parameters are floating-point numbers determining the size of the 
graphics image window, the image being scaled independently in the x- and 
y-directions to fit within the graphics window. 


Scaling up is performed only by factors of 1, 2, 3, and so forth (integers only). 
Each bit in the graphics image is mapped onto a small rectangular area on the 
screen. If the window is smaller than the provided graphics image in either 
dimension, a scale factor of one is used in that dimension. 


Parameters 
type (4-byte binary integer) 
The type of the graphics image to be drawn. Must be set to 0. 


width (4-byte binary integer) 
The width of the graphics image in pixels. It must be smaller than 2040. 


depth (4-byte binary integer) 
The depth of the graphics image in pixels. 


length (4-byte binary integer) 
The length in bytes of the graphics image data. 


graphics-image-data (character string) 
The graphics image data to be displayed. The pixels must be given row by 
row, starting at the top and running from left to right within each row. 


x-size (short floating-point number) 
The size of the graphics image window in the x direction. 


y-size (short floating-point number) 
The size of the graphics image window in the y direction. 
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Coding Example 
The following example shows how to use GSIMGS: 


OPTION BASE 1 

! Move current position to center of screen 
CALL GDDM('GSMOVE',50.0,50.0) 

! Set up graphics image 

DIM CROSS$*8 

LET CROSS$ = HEX$('81422418244281') 

CALL GDDM('GSIMG',0,8,7,7,CROSS$,10.0,10.0) 


RV2F741-0 
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GSLINE-Draw a Straight Line 


GSLINE(x,y) 


Draws a straight line from the current position to the specified end point. 


The color, line width, and line type of the line are given by the current values of 
these attributes. The current position is set to the end point of the line. 


When the specified end point lies outside the window boundaries, the results 
(including current position) are undefined. Otherwise, if clipping is enabled, only 
the section of the line within the current window is visible. 


Parameters 
x,y (short floating-point numbers) 
The end point of the line in world coordinates. 


Coding Example 
The following example shows how to use GSLINE: 


CALL GDDM('GSLINE',3.5,6.0) 
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GSLSS-Load a Graphics Symbol Set from Auxiliary Storage 


GSLSS(type,symbol-set-name,symbol-set-id) 


Loads a set of symbol definitions from auxiliary storage. The symbol set is a 
graphics symbol set (*GSS) from a *GSS object. The library containing the 
graphics symbol set (usually QGDDM) must be in the library list of the user who 
calls the graphics application program. The symbol set is loaded for use by the 
current device, and must be loaded once for each device on which it is to be used. 


For more information on graphics symbol sets, refer to the GDDM Programming 
book. 


The definitions are retained by GDDM for graphics use. 


Parameters 
type (4-byte binary integer) 
The type and usage of this symbol set follow: 


1 Graphics image symbol set (used for character mode 2; see GSCM 
earlier in this chapter) 

2 Vector symbol set (used for character mode 3; see GSCM earlier in this 
chapter) 

3 Not supported on the AS/400 system 

4 Marker symbol set (ISS or VSS) 

5 DBCS language set 


symbol-set-name (8-byte character string) 
The name (left-justified) of the symbol set (“GSS) to be read from auxiliary 
storage. 


If a symbol set with the same name is loaded more than once, without first 
being released (see GSRSS), it is undefined whether GDDM uses the copy that 
it already has, or takes a new copy. 


Note: Although the AS/400 system allows object names to be 10 bytes long, 
this routine only accepts a maximum name length of 8 bytes. 


The following are the names of the symbol sets supplied with OS/400 Graphics: 


¢ For graphics image symbol sets (character-mode 2 only): 


— ADMMISSG (default for GDDM on the IPDS printers) 

— ADMMISSI (default for GDDM on the 5224/5225 printers and on the 
4234 Model 3 Printer @ 10 cpi) 

— ADMMISSP (default for GDDM on the 4234 Model 3 Printer @ 15 cpi) 


Note: For IPDS printers, the character set specified on the print file will be 
used for graphics image symbols. For information on specifying a 
print file, see Figure 2-2 on page 2-10. For more information, see 
the CHRID parameters on the CRTPRTF command in the CL 
Reference book. 
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e For vector symbol sets (character-mode 3 only): 


— ADMMVSS (default for graphics work stations and IBM plotters) 
— ADMDVSS (American English Standard characters) 

— ADMDVSSE (U.K. English Standard characters) 

— ADMDVSSF (French Standard characters) 

— ADMDVSSG (German Standard characters) 

— ADMDVSSI (Italian Standard characters) 

— ADMDVSSK (Katakana Standard characters) 

— ADMDVSSS (Spanish Standard characters) 

— ADMUVCIP (Complex Italic Principal) 

— ADMUWCIP (Complex Italic Principal; proportionally spaced) 

— ADMUVCRP (Complex Roman Principal) 

— ADMUWCRP (Complex Roman Principal; proportionally spaced) 
— ADMUVCSP (Complex Script Principal) 

— ADMUWCSP (Complex Script Principal; proportionally spaced) 
— ADMUVDRP (Duplex Roman Principal) 

— ADMUWDRP (Duplex Roman Principal; proportionally spaced) 
— ADMUVGEP (Gothic English Principal) 

— ADMUWGEP (Gothic English Principal; proportionally spaced) 
— ADMUVGGP (Gothic German Principal) 

— ADMUWGGP (Gothic German Principal; proportionally spaced) 
— ADMUVGIP (Gothic Italian Principal) 

— ADMUWGIP (Gothic Italian Principal; proportionally spaced) 

— ADMUVSRP (Simplex Roman Principal) 

— ADMUWSRP (Simplex Roman Principal; proportionally spaced) 
— ADMUVTIP (Triplex Italic Principal) 

— ADMUWTIP (Triplex Italic Principal; proportionally spaced) 

— ADMUVTRP (Triplex Roman Principal) 

— ADMUWTRP (Triplex Roman Principal; proportionally spaced) 

— ADMVMSS (Multinational Standard Simple) 

— ADMWMSS (Multinational Standard Simple; proportionally spaced) 
— ADMVMSB (Multinational Standard Bold) 

— ADMWMSB (Multinational Standard Bold; proportionally spaced) 
— ADMVMOB (Multinational Open Block) 

— ADMWMOB (Multinational Open Block; proportionally spaced) 

— ADMVMFB (Multinational Filled Block) 

— ADMWMEFB (Multinational Filled Block; proportionally spaced) 

— ADMVMRP (Multinational Roman Principal) 

— ADMWMRP (Multinational Roman Principal; proportionally spaced) 


e DBCS language set 


— ADMXk* (Japanese language) 

— ADMXH* (Korean language) 

— ADMXC* (Simplified Chinese language) 

— ADMXT* (Traditional Chinese language) 

For more information, see Appendix D, “Double-Byte Character Set 
Support.” 


e For marker symbol sets: 


— Any graphics image symbol set or vector symbol set may be used as a 
marker symbol set. 


Chapter 2. GDDM Routines 2-93 


GSLSS 


symbol-set-id (4-byte binary integer) 
The identifier by which your program refers to this symbol set in later 
statements. 


The allowable symbol-set-ids are: 


0 marker symbol sets or DBCS language sets 
65 through 223 other symbol sets 


If a symbol-set-id is the same as one issued previously for the same type, the 
new definitions replace the previous ones. 


Coding Example 

In the following example, two symbol sets are loaded. Then the program queries 
for as many as three symbol sets. The values returned by GDDM are shown after 
the example: 


OPTION BASE 1 
CALL GDDM('GSLSS',2, 'ADMUVDRP' ,65) 
CALL GDDM('GSLSS',2, 'ADMUVSRP' ,66) 


. (graphics processing) 


INTEGER TYP,SSIDS 
DIM TYP(3) ,SSNAMES$ (3) *8, SSIDS(3) 
CALL GDDM('GSQSS',3,TYP() , SSNAMES$(),SSIDS()) 


The values of elements in the arrays are as follows: 
e¢ TYP(1) is 65; TYP(2) is 66; TYP(3) is 0. 


SSNAME$(1) is 'ADMUVDRP'; 
SSNAMES(2) is '"ADMUVSRP’; 
SSNAMEG(3) is 


* SSIDS(1) is 65; SSIDS(2) is 66; SSIDS(3) is 0. 


Differences between the System/370 Computer and the AS/400 
System 

On the AS/400 system, symbol set types 3 (shading pattern set) and 5 (4250 
composed page printer font) are not supported. 
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GSLT 


GSLT-Set Current Line Type 


GSLT(line-type) 


Sets the current value of the line type attribute. Subsequent primitives using lines 
(that is, those constructed by GSLINE, GSARC, GSPLNE, GSELPS, GSPFLT, or 
GSVECM) have the specified line type until this is reset. 


The line-type attribute does not affect mode-3 characters that are drawn using 
GSCHAP or GSCHAR. These characters are always drawn using the default line 


type. 


Parameters 

line-type (4-byte binary integer) 
For valid values of line-type, see Appendix C, “Colors, Line-Types, Markers, 
and Shading Patterns.” 


Coding Example 
The following example shows how to code GSLT for dotted lines: 


CALL GDDM('GSLT',1) 
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GSLW 


GSLW-Set Current Line Width 


GSLW(line-width) 


Sets the current value of the line width attribute. Subsequent primitives that use 
lines have the specified width. 


The line-width attribute does not affect mode-3 characters that are drawn using 
GSCHAP or GSCHAR. These characters are always drawn using the default line 
width. 


Parameters 
line-width (4-byte binary integer) 
It must be one of the following values: 


Minimum Standard Maximum 
Device (value is 0) (value is 1) (value is 100) 
5292 Model 2 1 1 2 
IBM PCs 1 1 1 
IBM plotters 1 1 1 
Printers 1 1 2 


Note: The line width on a plotter is controlled by the width of the selected pen 
rather than by GSLW. To set the width of pens used in the plotter, see 
processing option group 12 under DSOPEN earlier in this chapter. 


Coding Example 


The following example shows how to code GSLW for double-width lines: 
CALL GDDM('GSLW',2) 
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GSMARK-Draw a Marker Symbol 


GSMARK(xy) 


Draws a single marker at a specified position. 


A marker is a symbol used to indicate a position. It is like a character, but is 
positioned by its center. 


The marker color is set by GSCOL, and the marker is set by GSMS. 


The current position is set to (x,y). 


Parameters 
x,y (short floating-point numbers) 
The position of the marker in world coordinates. 


Coding Example 
The following example shows how to code GSMARK: 


CALL GDDM('GSMARK',50.0,50.0) 
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GSMIX-Set Current Color-Mixing Mode 


GSMIX(color-mixing-mode) 


Controls how the color of a primitive is combined with any underlying color when 
lines or shaded areas cross. 


Not all mix modes are supported on all devices. A device-dependent alternative 
mode may be used instead. Figure 2-6 on page 2-99 shows how the different mix 
modes are interpreted on each of the graphics devices. Regardless of how the 
mode is interpreted by a particular device, any generated GDF will contain the 
correct mix mode order. 


Parameters 
color-mixing-mode (4-byte binary integer) 
One of the following: 


0 
1 
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Default, same as 2. 
Mix mode (OR mode). 


Display points common to two primitives (for example, a line crossing a 
color-shaded area) take the color resulting from the mixture of the two 
colors. Mixing is accomplished by ORing the color index values together. 
The binary value of the current color index is logically ORed with the 
binary value of the color index for the existing pixel to produce the new 
color index value. For mixing results, see Figure 2-7 on page 2-99. 


On a plotter, a modified mix mode is always used. In this mode, the color 
index values are not ORed together, but the resulting colors may appear 
to have been mixed together on the paper. 


Overpaint mode. 


Display points common to two primitives take the color of the current 
primitive. Any underlying color is not visible. On a plotter, overpaint is 
not supported. The device always operates in a modified mix mode. 


Underpaint mode. 


Display points common to two primitives retain the color specified for the 
first one drawn, unless that color was the background color (color 8). For 
example, if an area is shaded blue and then a yellow line is drawn across 
it, the line is visible only where it lies outside the blue area. However, if 
the shaded area is specified as color 8, the line is yellow throughout its 
length. 


Underpaint mode is not supported on the plotters or printers. 
For device token L79A3, mix mode 3 produces an underpaint GDF order. 
Exclusive-OR mode. 


Display points common to two primitives take the color resulting from the 
logical exclusive OR of the color index values. The binary value of the 
current color index is exclusively ORed with the binary value of the color 
index for the existing pixel to produce the new color index value. 


GSMIX 


This option allows part of a picture to be deleted without having to delete 
the whole picture and redrawing the part that is not to be deleted. 


On a plotter, exclusive-OR mode is not supported. The device always 
operates in a modified mix mode. On the printers, exclusive-OR mode is 
not supported. 


Figure 2-6. Color-Mixing Results on Different Devices 


Mix 

Mode GDDM Mix Mode Display Plotter scs IPDS 

Number Mix Mix Mode Printers Printers 
Mode 

0 Default, same as mode 2 Overpaint | Mix (modified) | Overpaint | Overpaint 

1 Mix (OR) Mix (modified) Mix (OR) Overpaint 

2 Overpaint | Mix (modified) | Overpaint | Overpaint 

3 Overpaint | Mix (modified) | Overpaint | Overpaint 

4 Exclusive OR Exclusive Mix (modified) Overpaint Overpaint 
OR 


The color that results from mixing any other two colors together in mix mode 1 is 
given in the following table and is independent of the order in which the colors are 
mixed. 


Figure 2-7. Results of Mixing Colors 
Original Color 
3 


Mixed 
With 
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For example, if color 2 is mixed with color 4, the result is color 6; color 3 mixed with 
color 5 produces color 7. 


Coding Example 


The following example shows how to code GSMIX: 
CALL GDDM('GSMIX',2) 


Differences between the System/370 Computer and the AS/400 
System 
On the AS/400 system, mix mode 3 (underpaint) is not supported. 


On the AS/400 system, mix mode 4 (exclusive OR) is supported. 
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GSMOVE 


GSMOVE-Move Without Drawing 


GSMOVE(x,y) 


Moves the current position to the specified point. 


If the specified position lies outside the window, the current position is undefined 
unless clipping has been enabled (see GSCLP). 


Parameters 

x,y (short floating-point numbers) 
A point in world coordinates to which the current position is to be moved. The 
new value of the current position is (x,y). 


Coding Example 
The following example shows how to code GSMOVE: 


CALL GDDM('GSMOVE',30.0,44.0) 
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GSMRKS 


GSMRKS-Draw a Series of Marker Symbols 


GSMRKS(count,xarray,yarray) 


Draws a series of markers at specified points. Marker color is set by GSCOL. The 
current position is set to the position of the last marker in the series. The marker 
symbol is set by GSMS. 


Parameters 

count (4-byte binary integer) 
The number of markers to be drawn. This is also the number of elements in 
xarray and yarray. 


xarray (array of short floating-point numbers) 
The x coordinates of the marker positions (in world coordinates). 


yarray (array of short floating-point numbers) 
The y coordinates of the marker positions (in world coordinates). 


Coding Example 


The following example shows how to code GSMRKS to draw four markers: 


OPTION BASE 1 

DECIMAL XARRAY, YARRAY 

DIM XARRAY (4) , YARRAY (4) 

MAT READ XARRAY 

DATA 0,2,4,6 

MAT READ YARRAY 

DATA 5,8,11,13 

CALL GDDM('GSMRKS',4, XARRAY () , YARRAY () ) 
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GSMS 


GSMS-Set Current Marker Symbol 


GSMS(marker-symbol) 


Selects the current marker symbol to be used by calls to GSMARK and GSMRKS. 


Parameters 

marker-symbol (4-byte binary integer) 
The marker symbol. The default is 0 (a cross; same as marker symbol 1). 
For valid values of markers, see Appendix C, “Colors, Line-Types, Markers, 
and Shading Patterns.” 


Coding Example 
The following example shows how to code GSMS to set subsequent markers to 
shaded squares: 


CALL GDDM('GSMS' ,8) 
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GSMSC-Set Marker Scale 


GSMSC (scale) 


Sets the size for subsequent marker symbols. The scale parameter determines the 
scale of the marker symbol with respect to the default marker box. If the marker 
scale is not specified before to drawing the first vector marker, a scale of 1 is 
assumed. The default marker box is a square whose sides are equal to the width 
of the default character box. 


Parameters 
scale (short floating-point number) 
The scaling of the marker box with respect to the default marker box. 


The scale must be greater than 0. 
Coding Example 


The following example shows how to code GSMSC to get markers twice as large 
as the default: 


CALL GDDM('GSMSC' ,2.0) 
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GSPAT-Set Current Shading Pattern 


GSPAT(pattern-number) 


Sets the current value of the pattern attribute. Subsequent shading (area fill) uses 
the specified pattern until this is reset. 


Parameters 
pattern-number (4-byte binary integer) 
The number of the shading pattern to be used. 


Valid values are: 


0 Default (solid) 
1 through 16 ~IBM-supplied patterns as shown in Appendix C, “Colors, 
Line-Types, Markers, and Shading Patterns.” 


Coding Example 


The following example shows how to code GSPAT: 
CALL GDDM('GSPAT' ,3) 


Differences between the System/370 Computer and the AS/400 
System 

On the AS/400 system, shading patterns 65 through 239 (user-defined patterns on 
the System/370 computer) are not supported. 
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GSPFLT 


GSPFLT-Draw a Curved Fillet 


GSPFLT(count,xarray,yarray) 


Draws a curve starting at current position and defined by the xarray and yarray 
parameters. 


As shown in the coding examples later in this function description, if two points are 
supplied, an imaginary line is drawn from the current position to the first point, and 
a second line is drawn from the first point to the second. A curve is then 
constructed, starting at the current position and in the direction of the first line. The 
curve is drawn such that it reaches the last point at a tangent to the second line, 
having followed a path somewhat like a curve of pursuit. 


The curve has the appearance of a fillet. 


If you specify more than two points, an imaginary series of lines is constructed 
through them (like GSPLNE). All the lines except the first and last are then divided 
in two at their mid-points. A series of curved fillets are then drawn each starting at 
the end point of the last. 


The curves have color, line width, and line type given by the current values of these 
attributes. The current position is set to the last point. 


Parameters 
count (4-byte binary integer) 
The number of points defined by xarray and yarray. 


Xarray,yarray (array of short floating-point numbers) 
Two arrays whose elements specify the points defining the curve. 


Coding Examples 
Example 1: This example uses GSPFLT to draw the line shown following the 
example: 


OPTION BASE 1 

DECIMAL XARRAY, YARRAY 
DIM XARRAY (2) , YARRAY (2) 
MAT READ XARRAY 

DATA 0,20 

MAT READ YARRAY 

DATA 20,40 


. (graphics processing) 
! Set current position 


CALL GDDM('GSMOVE',22.0,10.0) 
CALL GDDM('GSPFLT',2,XARRAY () , YARRAY ()) 
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Where: 


e Aiscurrentposition. 


* BandC are points specified 
in xarray and yarray. 


RV2F742-0 


Example 2: 


OPTION BASE 1 

DECIMAL XARRAY, YARRAY 
DIM XARRAY (3) , YARRAY (3) 
MAT READ XARRAY 

DATA 0,10,20 

MAT READ YARRAY 

DATA 10,0,0 


. (graphics processing) 
! Set current position 


CALL GDDM('GSMOVE',7.0,28.0) 
CALL GDDM('GSPFLT',3,XARRAY () , YARRAY () ) 


A 
%y 
Fo Where: 
fa 

Pa 

x e Aisthecurrent position. 
Be 

4 ° B,C, and D are points specified 

\, in xarray and yarray. 


RV2F743-1 
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GSPLNE 


GSPLNE-Draw a Series of Lines 


GSPLNE(count,xarray,yarray) 


Draws a series of straight lines (sometimes called a polyline) starting at the current 
position and passing through the points defined by the xarray and yarray 
parameters. 


The color, line width, and line type of the lines are given by the current values of 
these attributes. The current position is set to the end point of the last line in the 
series. 


Parameters 
count (4-byte binary integer) 
The number of points to be passed through. 


xarray,yarray (arrays of short floating-point numbers) 
The end points of the lines. After drawing each line in the series, the current 
position is set to the end point of that line. The nth line is constructed by 
drawing a line from the current position to the point whose x coordinate is the 
nth element of xarray and whose y coordinate is the nth element of yarray. 


Coding Example 


In this example, the program uses GSPLNE to draw a series of lines: 


OPTION BASE 1 

DECIMAL XARRAY, YARRAY 

DIM XARRAY (5) , YARRAY (5) 

MAT READ XARRAY 

DATA 0,0,4,4,5 

MAT READ YARRAY 

DATA 0,4,4,0,0 

CALL GDDM('GSPLNE',5,XARRAY () , YARRAY () ) 


wee] ewer ere eee ce eerererrereeceeceeeereeecerceeececccccece 


Chapter 2. GDDM Routines 2-107 


GSPS 


GSPS-—Define the Picture Space 


GSPS (width, height) 


Explicitly defines the picture space to be used in the current graphics field. The 
picture space defines the aspect ratio (the ratio of width to height) of the picture 
unless viewports are also defined with a call to GSVIEW. 


Use GSPS to set up a desirable aspect ratio (the ratio of width to height). You 
should specify a one-to-one aspect ratio for pictures in which the vertical and 
horizontal scales should be the same, such as circles, and for any drawing which 
should be done to scale, such as a floor plan. 


The following shows the position of this call in the graphics hierarchy: 


Page FSPCRT 
Graphics GSFLD 
Picture space GSPS 
Viewport GSVIEW 
Window GSWIN 
Segment GSSEG 


The width and height specified are numbers between zero and one. These 
numbers define the aspect ratio of the picture to be drawn. 


The center of the picture space is mapped onto the center of the graphics field. 

The projection ratios are then adjusted so that the entire picture space is drawn in 
the graphics field, as large as possible while maintaining the aspect ratio specified. 
Either the left and right edges, or the top and bottom edges, of the picture space 
and graphics field coincide. All edges coincide only if the aspect ratios of picture 
space and graphics field are identical. If no graphics field is defined (using GSFLD) 
or defaulted before GSPS is issued, a default graphics field is set. 


A default picture space is used if no GSPS call is issued before: 
¢ The first viewport is defined or queried (GSVIEW or GSQVIE). 
¢ The first segment is opened (GSSEG). 
e The picture space is queried (GSQPS). 
e The first primitive or attribute is drawn or set (such as GSLINE or GSCOL). 
e The cursor is queried in graphics coordinates (GSQCUR). 


The default equals the actual aspect ratio (in physical units such as millimeters) of 
the graphics field. Note that this usually alters the aspect ratio from that drawn on 
the window, if viewports are not explicitly specified. The default picture space, 
therefore, covers the graphics field. 
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GSPS 


When GSVIEW, GSPS, and GSWIN have not been called, the default values are: 


¢ Ona graphics work station, the default width is 1 and the default height is 
0.529663. For an IBM PC, the default height is device dependent. 


¢ On plotters, the default width is 1 and the default height is 0.72. 


¢ On printers, the default width for the QPGDDM printer file (as shipped) is 1 and 
the default height is 0.757. 


At other times, the aspect ratio of the picture space can be obtained by a call to 
GSQPS. 


Once specified or taken by default, the picture space cannot be changed for that 
graphics field. 


Parameters 

width,height (short floating-point numbers) 
The width and height of the picture space. One of the numbers, width or 
height, must be 1; the other must be greater than 0 but not greater than 1. 


Coding Example 

In the following example, the program uses GSPS to define the picture space for a 
one-to-one aspect ratio. This causes vertical and horizontal distances specified in 
world coordinates to have the same scale. This is particularly important when 
drawing a picture to scale, such as a floor plan. 


CALL GDDM('GSPS',1.0,1.0) 
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GSPUT 


GSPUT-Draw Data from a Graphics Data Format File 


GSPUT(control,length,graphic-data) 


Draws the graphics data from a graphics data format (GDF) file. 


Any series of graphic primitives (such as lines, arcs, areas, and character strings) 
together with their attributes can be coded as a string of data bytes called a 
Graphics Data Format (GDF) file. This consists of a series of orders (see 
Appendix B, “GDF Order Descriptions”). Each order defines a graphics primitive or 
an attribute setting that applies to following primitives. 


When graphics data is stored by an application program in a GDF file, it can be 
supplied to GDDM by a single GSPUT call, rather than by a large number of calls 
to the individual primitives. 


The interpretation of a GDF order string is equivalent to the execution of CALL 
statements corresponding to the orders in the string. Current position depends on 
the last order executed, and the current values of the attributes (color, line type, 
and so on) depend on the attribute setting orders that have occurred. 


Note that errors can occur during interpretation of the individual orders as if 
corresponding calls had been made directly. 


Since the GDF orders do not contain any window information, a call to GSWIN 
must be made before the GSPUT is done. If the default window of (0,100,0,100) is 
used, only part of the original picture appears because the GDF assumes a window 
that can be as large as (0,32767,0,32767). Appropriate GSWIN parameters can be 
taken from the first comment order in the GDF (see the description given for 
GSGET). Similarly, the aspect ratio of the original picture can be restored by a call 
to GSPS using the difference in the x bounds for the width and the difference in the 
y bounds for the height. 


Parameters 
control (4-byte binary integer) 
The coordinate type used in the GDF data. On the AS/400 system, it must be: 


2 2-byte binary integers 


length (4-byte binary integer) 
The length of the string of GDF orders to be used in drawing (see the 
graphics-data parameter). The string of orders is assumed to end when an 
apparent order code of X'FF' is encountered, or when the complete string has 
been interpreted, whichever is the sooner. 


graphic-data (character) 
A character variable, whose length is specified by the length parameter, and 
whose value your program supplies, that is used by GDDM instead of separate 
calls to OS/400 Graphics routines. You can use GDF data that has been 
generated by GSGET for this parameter. The detailed rules for formatting the 
GDF string are given in Appendix B, “GDF Order Descriptions.” 
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GSPUT 


Coding Example 
The following example shows how to use GSPUT: 


OPTION BASE 1 
DIM BUF$*255 ! 255 is maximum allowed by BASIC 


. (processing to read first GDF order, which is a comment) 


! Loop that includes the following: 
CALL GDDM('GSPUT' ,2,255,BUF$) 


. (processing to read rest of GDF orders) 


! After all GDF orders have been read, send graphics to device 
! if desired 
CALL GDDM('FSFRCE') 


Note: Some GDF orders can require more than 255 bytes for the graphic-data 
parameter (in this example, BUF$). These include orders for graphics text 
(GSCHAP and GSCHAR with very long character strings), polyfillets, and 
polylines. If your graphics data includes such orders, you should use a 
language other than BASIC to write the program using GSPUT. 


Differences between the System/370 Computer and the AS/400 
System 

On the AS/400 system, control values other than 2 are not allowed; therefore all 
graphics data files must contain 2-byte binary integer coordinates. 
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GSQCA 


GSQCA-—Query the Current Character Angle 


GSQCA\(dx,dy) 


Returns the current slope of the character baseline. 


Parameters 
dx,dy (returned by GDDM) (short floating-point variables) 
The current slope of the character baseline. 


Coding Example 


The following example shows how to use GSQCA: 


DECIMAL DX,DY 
CALL GDDM('GSQCA' ,DX, DY) 
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GSQCB 


GSQCB-Query the Current Character Box Size 


GSQCB (width, height) 


Returns the current width and height of the character box. 


Parameters 
width,height (returned by GDDM) (short floating-point variables) 
The current dimensions of the character box. 


Coding Example 


The following example shows how to use GSQCB: 


DECIMAL WIDTH,HEIGHT 
CALL GDDM('GSQCB' ,WIDTH, HEIGHT) 
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GSQCD 


GSQCD-Query the Current Character Direction 


GSQCD(character-direction-code) 


Returns the code for the current character direction as set by GSCD. 


Parameters 

character-direction-code (returned by GDDM) (4-byte binary integer variable) 
The current character direction code, from 0 through 4. For an explanation of 
the codes, see “GSCD-Set Current Character Direction” on page 2-55. 


Coding Example 
The following example shows how to use GSQCD: 


INTEGER DIRECTION 
CALL GDDM('GSQCD' ,DIRECTION) 
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GSQCEL 


GSQCEL—Query the Current Hardware Cell Size 


GSQCEL (width, height) 


Returns the hardware cell size in current window units. This call can be used to 
determine the area bounded by the cell in which the cursor lies. 


For plotters and IPDS printers, GSQCEL returns a pseudo-cell size. This size is 
used as the default character box size as returned in GSQCB. 


Parameter 
width, height (returned by GDDM) (short floating-point variables) 
The dimensions of the character cell. 


Coding Example 
The following example shows how to use GSQCEL: 


DECIMAL WIDTH,HEIGHT 
CALL GDDM('GSQCEL' ,WIDTH, HEIGHT) 
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GSQCH 


GSQCH-Query the Current Character Shear 


GSQCH(dx,dy) 


Returns the current angle at which characters are sheared (this is set by GSCH). 


Parameters 
dx,dy (returned by GDDM) (short floating-point number variables) 
Values that define the angle at which characters are sheared. 


Coding Example 


The following example shows how to use GSQCH: 


DECIMAL DX,DY 
CALL GDDM('GSQCH' ,DX, DY) 
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GSQCLP 


GSQCLP-Query the Clipping Mode 


GSQCLP(clipping-mode) 


Returns the current clipping mode. 


Parameters 
state (returned by GDDM) (4-byte binary integer variable) 
The current clipping mode for the page. The values returned are: 


0 Clipping is disabled 
1 Clipping is enabled 
Coding Example 
The following example shows how to use GSQCLP: 


INTEGER CLPMODE 
CALL GDDM('GSQCLP' , CLPMODE) 
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GSQCM 


GSQCM-Query the Current Character Mode 


GSQCM(character-mode) 


Returns the current value of the character mode attribute (which is set by GSCM). 


Parameters 
character-mode (returned by GDDM) (4-byte binary integer variable) 
The current character mode. 


Coding Example 


The following example shows how to use GSQCM: 


INTEGER CHARMODE 
CALL GDDM('GSQCM' , CHARMODE) 
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GSQCOL 


GSQCOL-Query the Current Color 


GSQCOL(color-index) 


Returns the current value of the color attribute (which is set by GSCOL). 


Parameters 
color-index (returned by GDDM) (4-byte binary integer variable) 
The current color attribute. 


Coding Example 


The following example shows how to use GSQCOL: 


INTEGER COLIND 
CALL GDDM('GSQCOL',COLIND) 
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GSQCP 


GSQCP-Query the Current Position 


GSQCP (x,y) 


Returns the current position. 


Parameters 
x,y (returned by GDDM) (short floating-point variables) 
The x and y world coordinates of the current position. 


Coding Example 


The following example shows how to use GSQCP: 


DECIMAL X,Y 
CALL GDDM('GSQCP',X,Y) 
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GSQCS 


GSQCS-—Query the Current Symbol Set Identifier 


GSQCS(symbol-set-id) 


Returns the current symbol set identifier. 


Parameters 
symbol-set-id (returned by GDDM) (4-byte binary integer variables) 
The current symbol set identifier. 


Coding Example 


The following example shows how to use GSQCS: 


INTEGER SSID 
CALL GDDM('GSQCS',SSID) 
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GSQCT 


GSQCT-Query the Current Color Table 


GSQCT(color-table-id) 


Returns the current color table identifier. 


Parameters 

color-table-id (returned by GDDM) (4-byte binary integer) 
Receives the current color table identifier. If no color table has been selected 
explicitly by the GSCT function, a value of zero is returned. 


Coding Example 
The following example shows how to use GSQCT: 


INTEGER COLTABID 
CALL GDDM('GSQCT' ,COLTABID) 


Differences between the System/370 Computer and the AS/400 


System 
This function is not supported on the System/370 computer. 
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GSQCTD 


GSQCTD-Query the Color Table Definition 


GSQCTD(color-table-id,start-color,count,hue-array, lightness-array, 
saturation-array) 


Returns the values of the entries in a color table. 


Parameters 
color-table-id (4-byte binary integer) 
The identification of the color table. 


start-color (4-byte binary integer) 
The number of the first entry in the table to be returned. If the whole table is to 
be returned, this should be set to 1. 


count (4-byte binary integer) 
The number of color table entries to be returned. If the whole table is to be 
returned, this should be set to the size of the table (8). 


hue-array (returned by GDDM) (array of short floating-point numbers) 
The hue values for each of the table entries being returned. Values range from 
0.0 through 1.0, with 0.0 and 1.0 indicating blue, and intermediate values 
indicating other hues. 


lightness-array (returned by GDDM) (array of short floating-point numbers) 
The lightness values for each of the table entries being returned. Values range 
from 0.0 through 1.0, with 0.0 indicating the least lightness (black), 1.0 
indicating the most (white), and intermediate values indicating degrees 
between. 


saturation-array (returned by GDDM) (array of short floating-point numbers) 
The saturation values for each of the table entries being returned. Values 
range from 0.0 through 1.0, with 0.0 indicating a completely unsaturated color 
(gray), 1.0 indicating full saturation, and intermediate values indicating degrees 
between. 


Coding Example 
The following example shows how to use GSQCTD to query the characteristics of 
the whole color table: 

OPTION BASE 1 

DECIMAL HUE_ARR,LT_ARR,SAT_ARR 

DIM HUE_ARR(8) ,LT_ARR(8) ,SAT_ARR(8) 

CALL GDDM('GSQCTD',65,1,8,HUE_ARR(),LT_ARR(),SAT_ARR()) 


Differences between the System/370 Computer and the AS/400 


System 
This function is not supported on the System/370 computer. 
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GSQCUR 


GSQCUR-Query the Cursor Position 


GSQCUR(inwin,x,y) 


Returns the cursor position in current window units. The position returned is that of 
the cursor as last set by ASREAD. The x and y are in world coordinates. 


Parameters 
inwin (returned by GDDM) (4-byte binary integer variable) 
One of the following: 


0 The cursor is outside the window 
1 The cursor is within the window 


x,y (returned by GDDM) (short floating-point variables) 
The x and y coordinates of the center of the character cell containing the 
cursor. 


Coding Example 
The following example shows how to use GSQCUR: 


INTEGER INWIN 
DECIMAL X,Y 
CALL GDDM('GSQCUR', INWIN,X,Y) 
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GSQFLW 


GSQFLW-Query the Current Fractional Line Width 


GSQFLW (linewidth-multiplier) 


Returns the current line width as a floating-point value. 


Parameters 
linewidth-multiplier (returned by GDDM) (short floating-point variable) 
The current value of the fractional line width. 


Coding Example 


The following example shows how to use GSQFLW: 


DECIMAL LWMULT 
CALL GDDM('GSQFLW' , LWMULT) 
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GSQLT 


GSQLT-Query the Current Line Type 


GSQLTi(line-type) 


Returns the current value of the line type. 


Parameters 

line-type (returned by GDDM) (4-byte binary integers) 
The current line type, from 0 through 8. For an explanation of the line type, 
see “GSLT-Set Current Line Type” on page 2-95. 


Coding Example 
The following example shows how to use GSQLT: 


INTEGER LINTYP 
CALL GDDM('GSQLT' ,LINTYP) 
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GSQLW 


GSQLW-Query the Current Line Width 


GSQLW(line-width) 


Returns the current value of the line width. If the current line width is fractional, the 
integral part is returned. To obtain the fractional part, use GSQFLW. 


Parameters 

line-width (returned by GDDM) (4-byte binary integer variable) 
The integer part of the value of the current line width, from 0 through 2. For an 
explanation of the line width, see “GSLW-Set Current Line Width” on 
page 2-96. 


Coding Example 
The following example shows how to use GSQLW: 


INTEGER LINWID 
CALL GDDM('GSQLW' ,LINWID) 
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GSQMAX 


GSQMAX-—Query the Number of Segments 


GSQMAX(number-of-segments,max-segment) 


Returns the number of segment identifiers and the maximum segment identifier on 
the current page. 


Parameters 
number-of-segments (returned by GDDM) (4-byte binary integer variable) 
The number of segments currently defined. 


max-segment (returned by GDDM) (4-byte binary integer variable) 
The maximum segment identifier currently defined. 


Coding Example 
The following example shows how to use GSQMAX: 


INTEGER NUMSEG,MAXSEGID 
CALL GDDM('GSQMAX' , NUMSEG,MAXSEGID) 
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GSQMIX 


GSQMIX—-Query the Current Color-Mixing Mode 


GSQMIX(color-mixing-mode) 


Returns the current value of the color-mixing mode. 


Parameters 
color-mixing-mode (returned by GDDM) (4-byte binary integer variable) 
The current value of the color-mixing mode. Possible values are: 


0 
1 


2 
3 
4 


Default. This is the same as a value of 2. 

Mix mode. Where two primitives cross, the color displayed is a mixture of 
the two colors. For the results of mixing, see Figure 2-7 on page 2-99. 
Overpaint mode. The color of the current primitive takes precedence. 
Underpaint mode. The color of the first primitive drawn takes precedence. 
Exclusive-OR mode. Where two primitives cross, the resulting color is a 
result of the logical exclusive OR of the color index values. 


Coding Example 
The following example shows how to use GSQMIX: 


INTEGER MIXMOD 
CALL GDDM('GSQMIX' ,MIXMOD) 
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GSQMS 


GSQMS-Query the Current Marker Symbol 


GSQMS(marker-type) 


Returns the current marker symbol number. 


Parameters 

marker-type (returned by GDDM) (4-byte binary integer variable) 
The current marker symbol number for the current graphics segment. The 
number can be from 0 through 10 or from 65 through 254. For an explanation 
of the marker types, see “GSMS-Set Current Marker Symbol” on page 2-102. 


Coding Example 
The following example shows how to use GSQMS: 


INTEGER MRKTYP 
CALL GDDM('GSQMS' ,MRKTYP) 
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GSQMSC 


GSQMSC-Query the Current Marker Scale 


GSQMSC (scale) 


Returns the current marker scale to be used when drawing marker symbols defined 
as vector symbols. 


Parameters 
scale (returned by GDDM) (short floating-point variable) 
The scale of marker symbols with respect to the default marker box. 


Coding Example 
The following example shows how to use GSQMSC: 


DECIMAL SCAL 
CALL GDDM('GSQMSC',SCAL) 
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GSQNSS 


GSQNSS-Query the Number of Loaded Symbol Sets 


GSQNSS(number-of-symbol-sets) 


Returns the number of loaded symbol sets. This call allows you to specify an 
accurate count parameter value on a subsequent GSQSS request. 


Parameters 
number-of-symbol-sets (returned by GDDM) (4-byte binary integer variable) 
The number of symbol sets loaded by GSLSS. 


Coding Example 
The following example shows how to use GSQNSS: 


INTEGER NUMSS 
CALL GDDM('GSQNSS',NUMSS) 
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GSQPAT 


GSQPAT-—Query the Current Shading Pattern 


GSQPAT(pattern-number) 


Returns the current shading pattern number. 


Parameters 

pattern-number (returned by GDDM) (4-byte binary integer variable) 
The current shading pattern number, from 0 through 16. For an explanation of 
the pattern numbers, see “GSPAT-Set Current Shading Pattern” on 
page 2-104. 


Coding Example 
The following example shows how to use GSQPAT: 


INTEGER PATNUM 
CALL GDDM('GSQPAT', PATNUM) 


Chapter 2. GDDM Routines 2-133 


GSQPS 


GSQPS-Query the Picture Space Definition 


GSQPS (width, height) 


Returns the picture space definition. This call can be used to adapt a picture layout 
to suit the shape of the graphics field. 


Parameters 

width,height (returned by GDDM) (short floating-point variables) 
The width and height of the picture space. One of the values returned is 1; the 
other is less than or equal to 1. 


Coding Example 


The following example shows how to use GSQPS to set the viewport to be the 
same as the graphics field: 
DECIMAL WIDTH, HEIGHT 


CALL GDDM('GSQPS' ,WIDTH, HEIGHT) 
CALL GDDM('GSVIEW',0.0,WIDTH,0.0,HEIGHT) 
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GSQSEN 


GSQSEN-Query Mixed-String Attribute of Graphic Text 


GSQSEN(mixedval) 


Returns the current value of mixed-string attribute set by GSSEN. 


Parameters 
mixedval (returned by GDDM) (4-byte binary integer variable) 
Receives the mixed string attribute. The values are: 


0 Default. This is the same as a value of 1. 

1 Mixed with position. Shift-out/shift-in (SO/SI) characters are output as 
blanks. 

2 Mixed without position. SO/SI characters do not take up a character 
position in the output. 


Coding Example 
The following example shows how to use GSQSEN: 


CALL GDDM('GSQSEN',mixedval) 
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GSQSS 


GSQSS-—Query Loaded Symbol Sets 


GSQSS(count,types, symbol-set-names,symbol-set-ids) 


Returns information about symbol sets loaded by GSLSS. 


Each of the parameters (except the count parameter) is an array. The count 
parameter specifies the number of symbol sets to be queried. The array 
parameters return information about the symbol sets that were loaded first after 
graphics was last initialized. If there are fewer arrays loaded than specified in the 
count parameter, the remaining elements in the symbol-set-ids array are not 
changed from their former value. 


Parameters 
count (4-byte binary integer variable) 
The number of loaded symbol sets. 


types (returned by GDDM) (array of 4-byte binary integer variables) 
The types of symbol definitions, which are: 


Image symbol set 
Vector symbol set 
Marker symbol set 
5 DBCS language set 


Aho 


symbol-set-names (returned by GDDM) (array of 8-byte character variables) 
The *GSS object names from which the symbol sets were loaded. 


symbol-set-ids (returned by GDDM) (array of 4-byte binary integer variables) 
The identifiers associated with each symbol set. 


Coding Example 
The following example shows how to query as many as four current graphics 
symbol sets: 


OPTION BASE 1 

INTEGER COUNT, TYPS,SSIDS 

DIM TYPS(4) 

DIM SSIDS(4) 

DIM SSNAMES$(4) *8 

CALL GDDM('GSQSS',COUNT, TYPS(),SSNAMES$() ,SSIDS()) 


Differences between the System/370 Computer and the AS/400 
System 

On the AS/400 system, excess array elements are not set to zero or blank. Also, 
symbol set types 3 (shading pattern set) and 5 (4250 composed page printer font) 
are not supported. 
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GSQTB 


GSQTB-Query the Text Box 


GSQTBilength, string ,count,xarray,yarray) 


Returns the x and y components of the relative coordinates of the four corners of 
the text box. The text box is the parallelogram that encloses the character string. 
Also returned are the relative coordinates of the concatenation point; that is, the 
position where the next character would be. All coordinates are relative to the 
starting point, as defined in the GSCD call. The box is evaluated using the current 
character mode, box, angle, shear, direction, and set. 


Parameters 
length (4-byte binary integer) 
The number of characters in the string. 


string (character string) 
The character string to be processed. 


count (4-byte binary integer) 
The number of elements in xarray and yarray. Any values after the fifth are 
ignored. 


xarray,yarray (returned by GDDM) (short floating-point variables) 
The relative coordinates of the text box as follows: 


Element 1: Top left corner 
Element 2: Bottom left corner 
Element 3: Top right corner 
Element 4: Bottom right corner 
Element 5: Concatenation point 


The terms top left and so on are literally true when the baseline is parallel to the x 
axis and running left to right, and there is no character shear. If the character 
string is rotated or sheared, the term top /eft applies to the corner of the box that 
appears top left when no rotation or shear is applied. 

Bottom Right 


Top Right 


Bottom Left 


Top Left 


RV2F745-0 
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GSQTB 


Coding Example 
The following example shows how GSQTB is used: 
OPTION BASE 1 
DECIMAL XARRAY, YARRAY 
DIM XARRAY (5) , YARRAY (5) 
CALL GDDM('GSQTB',5, 'ABCDE',5,XARRAY() , YARRAY ()) 


Differences between the System/370 Computer and the AS/400 


System 
On the AS/400 system, any excess array elements are not set to zero. 
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GSQVIE 


GSQVIE-Query the Current Viewport Definition 


GSQVIE (left-boundary, right-boundary,lower-boundary upper-boundary) 


Returns the current viewport definition. 


Parameters 

left-boundary,right-boundary (returned by GDDM) (short floating-point variables) 
The position within the picture space of the left and right boundaries of the 
viewport. 


lower-boundary,upper-boundary (returned by GDDM) (short floating-point 
variables) 
The position within the picture space of the lower and upper boundaries of the 
viewport. 


Coding Example 
The following example shows how to use GSQVIE: 


DECIMAL X1,X2,Y1,Y2 
CALL GDDM('GSQVIE',X1,X2,Y1, Y2) 


Chapter 2. GDDM Routines 2-139 


GSQWIN 


GSQWIN-Query the Current Window Definition 


GSQWINileft-boundary, right-boundary,lower-boundary,upper-boundary) 


Returns the current window definition. 


Parameters 
left-boundary,right-boundary (returned by GDDM) (short floating-point variables) 
The left and right boundaries of the window. 


lower-boundary,upper-boundary (returned by GDDM) (short floating-point 
variables) 
The lower and upper boundaries of the window. 


Coding Example 


The following example shows how to use GSQWIN: 


DECIMAL LEFTB,RIGHTB, LOWB,UPPB 
CALL GDDM('GSQWIN', LEFTB, RIGHTB, LOWB, UPPB) 
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GSRSS 


GSRSS-Releasing a Graphics Symbol Set 


GSRSS(type,symbol-set-id) 


Releases the symbol set specified. The type must correspond exactly to that 
specified when the symbol set was loaded. A symbol set can be released, freeing 
the storage occupied, when the application program no longer needs it. A set 
should not be released while a graphics picture using it still exists. 


Parameters 
type (4-byte binary integer) 
The type of the symbol set to be released, being either: 


1 ISS (image symbol set) 
2 VSS (vector symbol set) 
4 Marker symbol set (ISS or VSS) 


symbol-set-id (4-byte binary integer) 
The identifier of the symbol set to be released (see “GSLSS—Load a Graphics 
Symbol Set from Auxiliary Storage” on page 2-92). 


Coding Example 


In the following example, the program releases the symbol set for Duplex Roman 
Principal. 


CALL GDDM('GSRSS' ,2,65) 
Differences between the System/370 Computer and the AS/400 


System 
The System/370 computer also supports symbol set types 3 (shading pattern set). 
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GSSCLS 


GSSCLS-Close the Current Segment 


GSSCLS 


Causes the current segment to be closed, so that no more primitives can be added 
to it. After this operation, there is no current segment within the page. Closing a 
segment does not delete the segment or affect the graphics primitives that are 
displayed. 


Parameters 
None. 


Coding Example 


The following example shows how to use GSSCLS: 
CALL GDDM('GSSCLS') 
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GSSDEL 


GSSDEL—Delete a Segment 


GSSDEL(segment-id) 


Causes the specified segment, together with any graphics primitives defined within 
it, to be deleted. 


When a visible segment is deleted, all other segments are redisplayed; however, 
the effect appears at the device only at the next ASREAD or FSFRCE. 


If the segment is current when it is deleted, there is no current segment after this 
operation. 


Parameters 
segment-id (4-byte binary integer) 
The identifier of the segment to be deleted. 


Coding Example 
The following example shows how to use GSSDEL: 


CALL GDDM('GSSDEL',4) 
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GSSEG 


GSSEG-Create a Segment 


GSSEG(segment-id) 


Creates a segment with the specified identification number. A segment is a group 
of graphics primitives that share the current viewport and window. 


Use GSSEG for the following: 


To group graphics primitives together. 
To reset all attributes to defaults. 
To set the current position at the world-coordinate origin. 


When your program will store a picture (using GSGET) in a graphics data file. 
This is called retained data. For a description of retained and temporary data, 
refer to the GDDM Programming book. 


The segment created becomes the current segment, to which subsequent primitives 
are added. The window and viewport cannot be changed while a segment is being 
constructed. 


The following shows the position of this call in the graphics hierarchy: 


Page FSPCRT 
Graphics field GSFLD 
Picture space GSPS 


Viewport GSVIEW 
Window GSWIN 
Segment GSSEG 
Parameters 


segment-id (4-byte binary integer) 


The identifier of the segment (can be zero). 


If this parameter is zero, the segment is unnamed and cannot be explicitly 
deleted. If the segment-id is nonzero (and positive), it must be unique within 
the current page. Segment identifier 32,767 is reserved and cannot be used. 


Coding Example 


The following example shows how to use GSSEG: 


CALL GDDM('GSSEG' ,4) 
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GSSEN 


GSSEN-Set Mixed-String Attribute of Graphic Text 


GSSEN(mixed) 


Specifies if the mixed string in the graphic text is to take a 1-byte position between 
single-byte and double-byte characters. 


Parameters 
mixed (4-byte binary integer) 
Specifies the mixed string attribute. The values are: 


0 Default. This is the same as a value of 1. 

1 Mixed with position. Shift-out/shift-in (SO/SI) characters are output as 
blanks. 

2 Mixed without position. SO/SI characters do not take up a character 
position in the output. 


Coding Example 
The following example shows how to use GSSEN: 


CALL GDDM('GSSEN',1) 
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GSVECM 


GSVECM-Vectors 


GSVECM(count,vector) 


Performs a series of operations, which either draw a line or move the current 
position to a specified end point. The color, line width, and line type of lines drawn 
are given by the current values of these attributes. 


The current position is set to the last end point. 


If clipping is disabled and any specified point lies outside the window boundaries, 
that line, subsequent lines, and current position are undefined. If clipping is 
enabled, only those sections of the lines within the current window are visible. 


Parameters 
count (4-byte binary integer) 
The total number of lines or moves to be performed. 


vector (array of 4-byte binary integers) 
A series of operations in the order (control1,x1,y1, control2,x2,y2, ... 
controli,xi,yi,.... controln,xn,yn), where for each operation the control value 
determines whether a line is drawn or a move is made. Control values can be: 


0 Move to the point (xi,yi) 
1 Draw a line to the point (xi, yi) 


Coding Example 


In the following example, the program uses GSVECM to draw a broken line: 


OPTION BASE 1 

INTEGER VECTOR 

DIM VECTOR(18) 

MAT READ VECTOR 

DATA 0,0,20, 1,2,20, 0,2,10, 1,4,10, 0,4,20, 1,6,20 
CALL GDDM('GSVECM',6,VECTOR() ) 


The following shows how the broken line is drawn: 


oe: — 
i. — 


wee eee e reer rere rere rrr ere receeceereeeeseere cece cceecece 
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GSVIEW 


GSVIEW-Define a Viewport 


GSVIEW (left-boundary ,right-boundary,lower-boundary upper-boundary) 


Explicitly specifies the current viewport boundaries in picture-space units. If not 
specified by GSPS earlier in the program, the width and height of the picture space 
depend on the device. You can use GSQPS to find out what they are. 


The following shows the position of this call in the graphics hierarchy: 


Page FSPCRT 
Graphics field GSFLD 
Picture space GSPS 


Viewport GSVIEW 
Window GSWIN 
Segment GSSEG 


If you do not use GSVIEW, the viewport takes up the whole of the picture space. 


A viewport is a subregion of the total picture space. Viewports can be used to 
position the parts of a composite picture. The viewport boundaries are parallel to 
those of the picture space, and must be entirely within the picture space. 


When the picture space of a graphics field is defined or defaulted, the current 
viewport is set to cover the complete picture space. By default, therefore, the 
viewport covers the picture space. 


lf GSVIEW, GSPS, and GSWIN have not been called, the default values are as 
follows: 


¢ Ona graphics work station, the left boundary is 0, the right boundary is 1, the 
lower boundary is 0, and the upper boundary is 0.529663. 


¢ On plotters, the left boundary is 0, the right boundary is 1, the lower boundary 
is 0, and the upper boundary is 0.72. 


¢ On printers, the default width for the QPGDDM printer file (as shipped) is 1 and 
the default height is 0.757. 


Parameters 

left-boundary,right-boundary (short floating-point numbers) 
The left and right viewport boundaries in picture-space units. The left boundary 
must not be larger than the right boundary. 


lower-boundary,upper-boundary (short floating-point numbers) 
The lower and upper viewport boundaries in picture-space units. The lower 
boundary must not be larger than the upper boundary. 


Coding Example 
The following example shows how to use GSVIEW: 
! Set picture space 
CALL GDDM('GSPS',1.0,0.4) 
! Set viewport 
CALL GDDM('GSVIEW', 0.0, 1.0, 0.0, 0.5) 
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GSWIN 


GSWIN-Define a Window 


GSWIN(left-boundary, right-boundary,lower-boundary,upper-boundary) 


Explicitly specifies the world coordinates to be used in drawing subsequent 
graphics primitives in the viewport. Before the first GSWIN is issued, the default 
values of the world coordinates are 0 through 100 in the x direction and 0 through 
100 in the y direction. 


The following shows the position of this call in the graphics hierarchy: 


Page FSPCRT 
Graphics field GSFLD 
Picture space GSPS 


Viewport GSVIEW 
Window GSWIN 
Segment GSSEG 


The world coordinates specified with this call are used to position all graphics 
primitives on the current page until a new window is specified. All graphics 
primitives in a segment must have the same window. 


Parameters 

left-boundary,right-boundary (short floating-point numbers) 
The left and right boundaries of the window. The left boundary is mapped to 
the left edge of the viewport, and the right boundary is mapped to the right. If 
clipping is in effect, no part of a primitive (line, arc, character, or area) is visible 
to the left of the left boundary, or to the right of the right boundary. 


lower-boundary,upper-boundary (short floating-point numbers) 
The lower and upper boundaries of the window. The lower boundary is 
mapped to the bottom of the viewport, and the upper boundary is mapped to 
the top. If clipping is in effect, no part of a primitive (line, arc, character, or 
area) is visible below the lower boundary or above the upper boundary. 


Coding Example 


The following example shows how to use GSWIN: 
CALL GDDM('GSWIN', 0.0, 200.0, 0.0, 200.0) 
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Data Types in GDDM 


Summary of Data Types for GDDM Routines 


Figure 2-8 is a table in which you can look up the parameter types for the GDDM 
routines. For example, for ASREAD, there are three parameters and they are all 
4-byte binary integers that must be variables so that GDDM can return values to 

your program. 
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Name 


Parm 1 


Parm 2 


Parm 3 


Parm 4 


Parm 5 


Parm 6 


Parm 7 


Parm 8 


ASREAD 
DSCLS 
DSDROP 
DSOPEN 
DSQDEV 
DSQUID 
DSQUSE 
DSRNIT 
DSUSE 
FSALRM 
FSEXIT 
FSFRCE 
FSINIT 
FSPCLR 
FSPCRT 
FSPDEL 
FSPQRY 
FSPSEL 
FSQCPG 
FSQDEV 
FSQERR 
FSQUPG 
FSREST 
FSRNIT 
FSTERM 
GSARC 
GSAREA 
GSCA 
GSCB 
GSCD 
GSCH 
GSCHAP 
GSCHAR 
GSCLP 
GSCLR 
GSCM 
GSCOL 
GSCS 
GSCT 
GSCTD 
GSELPS 
GSENDA 
GSFLD 
GSFLW 
GSGET 
GSGETE 
GSGETS 
GSIMG 
GSIMGS 


in var 


in var 


in 


in var 


in arr var 
ch var 


in var 


ch 
in 


in var 


in arr 


in var 


ch 


fp arr 


in arr 
in 


fp arr 
fp 


ch 
ch 


in 
ch arr 


fp arr 


ch arr 


in arr var 
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Figure 2-8 (Page 2 of 2). Summary of Data Types for the GDDM Routines 


in = 4-byte binary integer 

fp = Short floating-point number 

ch = Character string 

arr = Array 

var = Variable (whose value is returned by GDDM) 


Name Parm 1 Parm 2 Parm 3 Parm 4 Parm 5 Parm 6 Parm 7 Parm 8 
GSLINE fp fp 

GSLSS in ch in 

GSLT in 

GSLW in 

GSMARK fp fp 

GSMIX in 

GSMOVE fp fp 

GSMRKS in fp arr fp arr 

GSMS in 

GSMSC fp 

GSPAT in 

GSPFLT in fp arr fp arr 

GSPLNE in fp arr fp arr 

GSPS fp fp 

GSPUT in in ch 

GSQCA fp var fp var 

GSQCB fp var fp var 

GSQCD in var 

GSQCEL fp var fp var 

GSQCH fp var fp var 

GSQCLP in var 

GSQCM in var 

GSQCOL in var 

GSQCP fp var fp var 

GSQCS in 

GSQCT in var 

GSQCTD in in in fp arr var | fp arr var | fp arr var 
GSQCUR in var fp var fp var 

GSQFLW fp var 

GSQLT in var 

GSQLW in var 

GSQMAX in var in var 

GSQMIX in var 

GSQMS in var 

GSQMSC fp var 

GSQNSS in var 

GSQPAT in var 

GSQPS fp var fp var 

GSQSEN in var 

GSQSS in in arr var | ch arr var| in arr var 
GSQTB in ch in fp arr var | fp arr var 
GSQVIE fp var fp var fp var fp var 
GSQWIN fp var fp var fp var fp var 
GSRSS in in 

GSSCLS 

GSSDEL in 

GSSEG in 

GSSEN in 

GSVECM in in arr 

GSVIEW fp var fp var fp var fp var 
GSWIN fp var fp var fp var fp var 
Note: 
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Concepts of Presentation Graphics Routines 


Presentation Graphics routines can be used to draw the following types of chart: 


Line graphs 
Surface charts 
Bar charts 
Histograms 
Scatter plots 
Pie charts 


Venn diagrams 


The following is a list of some of the more important GDDM routines that affect 
Presentation Graphics routines (for a description of them, see Chapter 2). 


ASREAD (either ASREAD or FSFRCE required to get graphics output) 
FSFRCE (either ASREAD or FSFRCE required to get graphics output) 
FSINIT (required before using graphics calls) 

DSCLS 

DSDROP 

DSOPEN (DSOPEN and DSUSE both required to send output to a plotter) 
DSUSE (DSOPEN and DSUSE both required to send output to a plotter) 
FSEXIT 

FSPCRT 

FSRNIT 

FSTERM (required after using graphics calls) 

GSFLD 

GSLSS 

GSPS 


You can also use any of the GDDM query routines related to the above (such as 
DSQUSE and GSQPS). 


Figure 3-1 on page 3-2 shows the GDDM and Presentation Graphics routines to 
use for specific tasks you might have when using Presentation Graphics: 


Notes: 


1. 


At least one call from this group is required. 


2. Both of these calls are required. 
3. At least one of these calls is required. 
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Figure 3-1 (Page 1 of 3). Routines You Can Use in Presentation Graphics 


Chart Types 

Line charts CHPLOT 

Scatter plots CHPLOT 

Surface charts CHSURF 

Bar charts CHBAR (see note 1) 
Histograms CHHIST 

Pie charts CHPIE 

Venn diagrams CHVENN 


Drawing Charts with Presentation Graphics Routines 


Control operations 


¢ Graphics program 

e Error handling 

e Display controls 

¢ Symbol sets 

e Picture controls 

e Device open and close 
e Using devices 


FSINIT,FSRNIT,FSTERM (see note 2) 
FSEXIT 

ASREAD,FSFRCE,FSREST (see note 3) 
GSLSS,GSCS 

FSPCRT,GSPS,GSFLD 
DSOPEN,DSCLS,DSQUID,DSRNIT 
DSUSE,DSDROP,DSQUSE 


e Basic character box size 
Chart features 


e Headings 
— Text 
— Heading or no heading 
— Text attributes 
— Position 


¢ Chart legends 
— Drawing or not 
— For pie charts: legend or spider tags 
— Attributes 
— Legend position within margin 
— Final position (offset) 
— Maximum dimension 
— Order of items in legend 
— Blank legend area or not 
— Box or not 
— Labels for legend keys 


¢ Chart notes 
— Attributes 
— Note position and text 
— Final position (offset) 
— Blank note area or not 
— Box or not 


¢ Sounding device alarm FSALRM 
Chart Definition 
Chart layout 
e Size CHAREA 
e Margins CHHMAR,CHVMAR 
e« Frame CHSET(NCBOX|CBOX|CBACk),CHBATT 


CHCGRD 


CHHEAD 
CHSET(HEADING|NOHEADING) 
CHHATT 
CHSET(HTOP|HBOTTOM), 
CHSET(HCENTER|HLEFT|HRIGHT) 


CHSET(LEGEND|NOLEGEND) 
CHSET(PIEKEY|SPIDER) 
CHKATT 

CHKEYP 

CHKOFF 

CHKMAX 
CHSET(KNORMAL|KREVERSED) 
CHSET(NBKEY|BKEY) 
CHSET(NKBOX|KBOX) 

CHKEY 


CHNATT 
CHNOTE 

CHNOFF 
CHSET(NBNOTE|BNOTE) 
CHSET(NONBOX|NBOX) 
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Figure 3-1 (Page 2 of 3). Routines You Can Use in Presentation Graphics 


Chart features (continued) 


e Axes 
— Axis or no axis 
— Duplicate axis 
— Line attributes 
— Position 


— Type of scale 


— Range 
Explicit range 
Auto-ranging with zero 


Tick mark intervals 
Types of ticks 


— Axis title 
Text attributes 
Position 


Text 

— Axis labels 
Text attributes 
Position 


Axis label attributes 
Blank label area or not 
Type of label 


Scale factor 
Punctuate 4-digit integers or not 
Month labels 


Day labels 
Abbreviate month and day labels 
User-defined labels 
— When drawn 
When defined, after data plotted, 
suppressed 
Draw at specific time 
— Other reference lines 
- Grid lines 
Attributes 
Drawing or not 


- Axis translation lines and datum lines 
Attributes 
Drawing or not 


CHSET(AXIS|NOAXIS) 

CHSET(XNODUP|XDUP|YNODUP|YDUP) 

CHAATT 

CHXSET(LOWAXIS,MIDDLE,HIGHAXIS, INTERCEPT), 
CHXINT,CHYINT, 

CHSET(YVERTICAL|XVERTICAL) 

CHXSET(LINEAR|LOGARITHMIC), 
CHYSET(LINEAR|LOGARITHMIC) 


CHXRNG,CHYRNG, 
CHXSET(FORCEZERO|NOFORCEZERO), 
CHYSET(FORCEZERO|NOFORCEZERO) 
CHXTIC,CHYTIC 
CHXSET(NTICK|PTICK|XTICK|PLAIN), 
CHYSET(NTICK|PTICK|XTICK|PLAIN) 


CHTATT 
CHXSET(ATCENTER|ATEND|ATABOVE), 

CHYSET(ATCENTER|ATEND|ATABOVE) 
CHXTTL,CHYTTL 


CHLATT 
CHXSET(LABADJACENT|LABMIDDLE|NOLAB), 
CHYSET(LABADJACENT|LABMIDDLE|NOLAB) 
CHXLAT,CHYLAT 
CHSET(NBLABEL|BLABEL) 
CHXSET(NUMERIC|DATE|ALPHANUMERIC), 
CHYSET(NUMERIC|DATE|ALPHANUMERIC) 
CHXSCL,CHYSCL 
CHSET(NPGFS|PGFS) 
CHXMTH,CHYMTH 
CHXSET(NOSKIP|SKIP) 
CHYSET(NOSKIP|SKIP) 
CHXDAY,CHYDAY 
CHSET(ABREV|FULL|LETTER) 
CHXLAB,CHYLAB 


CHSET(IDRAW|DRAW|NDRAW), 
CHDRAX 
CHGATT 


CHXSET(NOGRID|GRID), 
CHYSET(NOGRID|GRID) 


CHDATT 
CHXDTM,CHYDTM 
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Drawing the Chart Using Component Attributes 


Line charts 


Scatter plots 


Surface charts 


Bar charts 


Multiple—bar charts 


Composite—bar charts 


Floating—bar charts 


Pie charts 


Multiple—pie chart 


Histograms 


Venn diagrams 


CHCOL,CHLT,CHMARK,CHSET(NOMARKERS), 
CHSET(CURVE),CHFINE,CHPLOT, 
CHSET(VALUES|NOVALUES), 
CHSET(BVALUES|NBVALUES) 


CHCOL,CHMARK,CHSET(LINES|NOLINES),CHPLOT 


CHCOL,CHSET(CURVE),CHFINE,CHPAT, 
CHSET(FILL|INFILL|NOFILL), 
CHSET(ABSOLUTE|RELATIVE),CHSURF, 
CHSET(VALUES|NOVALUES), 
CHSET(BVALUES|NBVALUES) 


CHCOL,CHPAT,CHSET(NOFILL), 
CHSET(CVALUES|VALUES|NOVALUES), 
CHSET(BVALUES|NBVALUES), 
CHVCHR,CHVATT,CHGAP,CHBAR 


Add to Bar charts: 
CHSET(MBAR),CHNUM 


Add to Bar charts: 
CHSET(CBAR),CHSET(RELATIVE) 


Add to Bar charts: 
CHSET(FBAR) 


CHCOL,CHPAT,CHSET(NOFILL),CHVCHR,CHVATT, 
CHSET(VALUES|NOVALUES), 
CHSET(BVALUES|NBVALUES), 
CHSET(SPISECTOR),CHSET(ABPIE),CHPIE, 
CHPCTL,CHPEXP 


Add to Pie charts: 
CHNUM,CHPIER,CHSET(PROPIE),CHXLAB 


CHCOL,CHSET(NOFILL),CHPAT,CHSET(RELATIVE), 
CHSET(NORISERS),CHHIST. 


CHCOL,CHSET(NOFILL),CHPAT,CHVENN 


More Chart Control Routines 


Reset processing state 
Reinitialize Presentation Graphics routines 
Terminate Presentation Graphics routines 


CHSTRT 
CHRNIT 
CHTERM 


Drawing charts involves two states: 


¢ State 1: Tailoring the default layout to suit your specific needs (also called 


chart definition). 


e¢ State 2: Passing the data and drawing the chart (also called chart 


construction). The calls CHBAR, CHHIST, CHPIE, CHPLOT, CHSURF, and 
CHVENN put your program in state 2. 


Calls in state 1 merely set up information to be used when the chart is constructed 
in state 2; therefore, they can be made in any order. Calls in state 2 cause the 
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construction of parts of the graph and are therefore irreversible (unless you start 
again from scratch by using CHSTRT). See Figure 3-2. 


Figure 3-2 (Page 1 of 3). Presentation Graphics Routines Valid in State 1 and State 
2 

CALL Description State 1 State 2 
CHAATT | Axis line attributes Y 

CHAREA | Chart area Y 

CHBAR Bar charts Y Y 
CHBATT | Framing box attributes Y 

CHCGRD| Character space and size Y 

CHCOL Color table Y 

CHDATT | Datum line attributes Y Y 
CHDRAX| Specific control of axis drawing Y 
CHFINE | Curve fitting smoothness Y Y 
CHGAP Spacing between bars Y Y 
CHGATT | Grid line attributes Y 

CHGGAP]| Spacing between bar groups Y Y 
CHHATT | Heading text attributes Y 

CHHEAD | Heading text Y 

CHHIST | Histograms Y Y 
CHHMAR| Chart margins Y 

CHKATT | Legend text attributes Y 

CHKEY Legend key labels Y 

CHKEYP | Legend base position Y 

CHKMAX]| Maximum legend width/height Y 

CHKOFF | Legend offsets Y 

CHLATT | Axis label text attributes Y 

CHLT Component line type table Y 

CHMARK| Component marker table Y 

CHNATT | Text attributes for note Y Y 
CHNOFF | Offsets for notes Y Y 
CHNOTE| Construct a chart note Y 
CHNUM | Set number of components Y Y 
CHPAT Component shading pattern table Y 

CHPCTL | Control pie chart slices Y 

CHPEXP | Exploded slices in pie charts Y 

CHPIE Pie charts Y Y 
CHPIER | Size specification Y 

CHPLOT | Line graphs and scatter plots Y Y 
CHRNIT | Reéinitialize Presentation Graphics routines Y 

CHSET Specify chart options (see following options) 
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Figure 3-2 (Page 2 of 3). Presentation Graphics Routines Valid in State 1 and State 
2 

CALL Description State 1 State 2 
ABRE Date label abbreviations Y 

ABSO Absolute or relative data Y 

BKEY Legend area blanked Y 

BLAB Label area blanked Y Y 
BNOT Note area blanked Y Y 
BVAL Blanking behind bar values Y Y 
CBOX Chart area boxed and shaded Y 

CURV Curve fitting Y Y 
FILL Shading method Y Y 
HCEN Heading justification Y 

HEAD Heading or no heading Y 

HTOP Heading position Y 

IDRA Time of drawing axes Y Y 
KNOR Order of elements in legend Y 

KBOX Box around legend Y 

LEGE Legend or no legend Y Y 
LINE Lines in line graphs Y Y 
MARK Markers on line graphs Y Y 
MBAR Type of bar chart Y Y 
NBOX Box around notes Y Y 
PERP Type of data for pie chart Y Y 
PGFS Punctuation of values Y Y 
PIEK Pie chart labeling Y 

PROP Relative sizes if pie charts Y 

RISE Risers in histograms Y Y 
SPIS Pie chart labeling Y Y 
VALU Values in pie and bar charts Y Y 
VONTOP Bar values in bar charts Y Y 
XDUP Secondary x axis Y Y 
YDUP Secondary y axis Y Y 
YVER Axis orientation Y 

CHSTRT | Reset to state 1 Y 
CHSURF | Surface charts Y Y 
CHTATT | Axis title text attributes Y 

CHTERM| Terminate Presentation Graphics routines Y Y 
CHVATT | Values text attributes (bar & pie) Y Y 
CHVCHR]| Number of bar chart characters Y Y 
CHVENN| Venn diagrams Y Y 
CHVMAR| Chart margins Y 

CHXDAY | Day labels Y 

CHYDAY | Day labels Y 
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Figure 3-2 (Page 3 of 3). Presentation Graphics Routines Valid in State 1 and State 
2 

CALL Description State 1 State 2 
CHXDTM| Datum lines Y Y 
CHYDTM| Datum lines Y Y 
CHXINT | Intercept Y 

CHYINT | Intercept Y 

CHXLAB | Label text Y 

CHYLAB | Label text Y 

CHXLAT | Label attributes Y 

CHYLAT | Label attributes Y 

CHXMTH| Month labels Y 

CHYMTH| Month labels Y 

CHXRNG|_ Explicit ranges Y 

CHYRNG| Explicit ranges Y 

CHXSCL | Scale factor Y 

CHYSCL | Scale factor Y 

CHXSEL | Axis selection Y Y 
CHYSEL | Axis selection Y Y 
CHXSET | Specify axis option (all options) Y 

CHYSET | Specify axis option (all options) Y 

CHXTIC | Scale mark interval Y 

CHYTIC | Scale mark interval Y 

CHXTTL | Axis title test Y 

CHYTTL | Axis title text Y 


Missing Data Values 


Each data group must contain the same number of x and y values. If one or more 
values is missing from the data, supply a dummy value. This value should be 1E20 
(102°) for the RPG/400 language, and 1E35 (1035) for all other supported 
languages. This type of dummy value is called a missing value. 


This applies to all chart types except Venn diagrams. 
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Alphabetic List of Presentation Graphics Routines 


Syntax Rules 


In this section, the Presentation Graphics routines, with their syntax and 
explanations, are listed alphabetically. 


The syntax is followed by a description of the routine, an explanation of the 
parameters, and a sample of the call in BASIC. For information on calling graphics 
routines in other languages, see “High-Level Languages” on page 1-2. 


The description also tells you in which state the call is valid. State 1 is the state of 
a program using Presentation Graphics routines before the first plot has been 
made. State 2 is the state of the program after the first plot has been made (which 
constructs the axes). 


All CHY... calls are listed under the equivalent CHX call. For example, CHYSCL is 
described with CHXSCL. 


The syntax shown for each Presentation Graphics routine includes all the 
parameters for the call. 


Each parameter shown is required; that is, if you use the graphics routine, you 
must specify something for each parameter, even if your program does not use the 
parameter or if the parameter is ignored on the AS/400 system. (This happens 
when the parameter is used on the System/370 computer but is not needed on the 
AS/400 system.) 


The syntax shown for each Presentation Graphics routine is not a complete CALL 
statement in any language. Only the parts of the syntax that are specific to OS/400 
Graphics are presented. This emphasizes the important aspects of the call. You 
must code a valid CALL statement in the language you are using. For example, 


CHHEAD (length, text) 
is representative of the syntax in this book. However, you would code 
CALL GDDM('CHHEAD',23,'Sample character string') 
in a BASIC program, and 
CALL CHHEAD(LENGTH,'Sample character string'); 
in a PL/I program. For more details on coding graphics calls in various languages, 
see “High-Level Languages” on page 1-2. 


You must specify the correct data types in your program. If the data types do not 
match those required by OS/400 Graphics, a function check can occur. 


The parameter names have been chosen to be as meaningful as possible. For 
example, in 

CHHEAD (length, text) 
length is the length of the text and text is a chart heading. 
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CHAATT-—Axis Line Attributes 


CHAATT(count,array) 


Overrides or resets the default attributes to be used for each axis line and its major 
and minor scale marks. 


The defaults are: 


Color 0 (green on displays, black on printers, highest pen number on 
plotters) 

Line type Solid 

Line width Normal 


Valid only in state 1. 


Parameters 

count (4-byte binary integer) 
The number of elements in the array parameter. If count is greater than 12, 
only 12 attributes are changed (the remainder of the elements in array have no 
effect). If count is less than 12, the rest of the attributes keep their previous 
setting. 


When count is zero, all defaults are reinstated. 


array (array of 4-byte binary integers) 
The attributes for the axes. The first set of three attributes is for the primary x 
axis, the second set is for the primary y axis, the third set is for the secondary x 
axis, and the fourth set is for the secondary y axis. 


1. Color (except for —1, valid values have the same effect as the GDDM 
routine GSCOL). 


For valid values of color, see Appendix C, “Colors, Line-Types, Markers, 
and Shading Patterns.” 


2. Line type (except for —1, valid values have the same effect as the GDDM 
routine GSLT). 


For valid values of line-type, see Appendix C, “Colors, Line-Types, 
Markers, and Shading Patterns.” 


3. Line width (except for —1, valid values have the same effect as the GDDM 
routine GSLW). Valid values are: 


-1 Leave unchanged 
0 Default (normal) 
1 Normal 
2 Double 
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Coding Example 


The following example shows how to use CHAATT: 


OPTION BASE 1 

INTEGER ATT 

DIM ATT(6) 

MAT READ ATT 

DATA -1,0,2, -1,0,2 

CALL GDDM('CHAATT',6,ATT()) 


In this example, color of both primary axes is left unchanged, their line types are 
the default (solid), and they are made double width. The secondary axes are left 
unchanged (because array ATT has only six elements). 
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CHAREA-Chart Area 


CHAREA(x1,x2,y1,y2) 


Overrides the default area to be used for the chart. 


By default, the whole of the screen (or printed page) is used to display the chart. If 
this is not your intention, you can specify a graphics field (using the GDDM call 
GSFLD) and optionally a picture space within the graphics field (using the GDDM 
call GSPS). 


Whether the graphics field and picture space have been explicitly defined or not, 
the chart area is specified in terms of the picture space. A call to the GDDM 
routine GSQPS must be used to obtain the defined or defaulted picture space 
dimensions. The parameters to CHAREA are then given as fractions of these 
values. 


CHSET(CBOX) or CHSET(CBACKk) can be used to draw a framing box around the 
chart area or to shade in the background. 


Valid only in state 1. 


Parameters 
x1,x2 (short floating-point numbers) 
The left and right boundaries of the chart area in picture-space units. 


y1,y2 (short floating-point numbers) 
The lower and upper boundaries of the chart area in picture-space units. 


Coding Example 


The following example shows how to use CHAREA: 
CALL GDDM('CHAREA', 0.0, 1.0, 0.0, 0.5) 
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CHBAR-Plot a Bar Chart 


CHBAR(data-groups,count,y-values) 


Plots one or more bar chart data groups on the currently selected axes. The type 
of bar chart constructed is as specified by the current chart-type setting of CHSET 
(MBAR|CBAR|FBAR). The possible choices are: multiple bar chart, composite bar 
chart, or floating bar chart. The shading is determined by the CHSET shading 
option. 


The bars or bar groups are centered about the x axis values 1, 2, 3, .... If 
autoranging applies, the x axis range is constructed to run from 0.5 through 
(count + 0.5). 


CHSET(CVALUES|VALUES) can be specified to show the data value at the end of 
each bar (multiple bar chart), or to annotate the last data group plotted (composite 
and floating bar charts). If there is no room for the data values, a GDDM message 
may result. 


Valid in state 1 or state 2. If coded in state 1, the program enters state 2. 


Parameters 

data-groups (4-byte binary integer) 
The number of data groups (types of bar) to be created. The bar for each data 
group has new attributes as indicated by the appropriate chart attribute tables. 


count (4-byte binary integer) 
The number of points on the x axis at which bars are placed (that is, the 
number of bars in each data group). All data groups must have the same 
number of bars. 


y-values (array of short floating-point numbers) 
The dependent data governing the lengths of the bars. For multiple data 
groups, the values must be stored sequentially by data group; that is, all values 
for the first data group, followed by all values for the second data group, and so 
forth, for as many data groups as specified. No array of independent values is 
necessary. 
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Coding Example 

This bar chart has three data groups (differently shaded bar types) each with two 
bars (two positions on the x axis labeled 1 and 2): 

7 a 


1 4 
0 a 
The following program displays this bar chart: 


OPTION BASE 1 

! Set type of chart to multiple-bar 
CALL GDDM('CHSET', 'MBAR') 

DECIMAL YARRAY 

DIM YARRAY (6) 

MAT READ YARRAY 

DATA 1.0, 2.2, 3.1, 4.0, 5.4, 6.1 
CALL GDDM('CHBAR' ,3,2, YARRAY ()) 


1 2 
RV2F747-0 


The MBAR option of CHSET was in use for this example. 
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CHBATT-Set Framing Box Attributes 


CHBATT(count,array) 


Overrides or resets the default attributes for the chart area background or the chart 
area frame box, if these are used. The chart area background is produced only 
when CHSET(CBACK) is used. A chart area framing box is produced only when 
CHSET(CBOX) is used. By default neither a background nor a box is produced. 


The defaults are: 


Color 7 is neutral 
Line type 0 is solid 
Line width 0 is normal 


Valid only in state 1. 


Parameters 

count (4-byte binary integer) 
The number of elements in the array parameter. If more than three elements 
are supplied, the excess elements are ignored. If fewer than three are 
supplied, the remainder are unchanged from their previous setting. 


When the count parameter is set to zero, the defaults are reinstated. 


array (array of 4-byte binary integers) 
The elements of the array are the following attributes: 


1. Color (valid values have the same effect as the GDDM routine GSCOL). 


For valid values of color, see Appendix C, “Colors, Line-Types, Markers, 
and Shading Patterns.” 


When the device does not support one or more of these colors, a 
device-dependent alternative is chosen. 


2. Line type (valid values have the same effect as the GDDM routine GSLT). 


For valid values of line-type, see Appendix C, “Colors, Line-Types, 
Markers, and Shading Patterns.” 


3. Line width (valid values have the same effect as the GDDM routine GSLW). 
Valid values are: 


0 Default (normal) 
1 Normal 
2 Double 
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Coding Example 
The following example shows how to use CHBATT to set up a framing box with a 
thick, solid, blue line: 


OPTION BASE 1 

CALL GDDM('CHSET', 'CBOX') 
INTEGER ATT 

DIM ATT(3) 

MAT READ ATT 

DATA 1,0,2 

CALL GDDM('CHBATT',3,ATT()) 
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CHCGRD-Basic Character Spacing/Size 


CHCGRD(n,m) 


Specifies the basic character size of all text constructed by Presentation Graphics 
routines (for example, axis labels, keys, chart headings, chart notes). The basic 
character size is multiplied by the character multiplier specified in the text attributes 
associated with each type of text, in order to obtain the actual text character size. 


The default basic character size is the size of the hardware characters of the 
primary device current at the time of transition from state 1 to state 2, reduced if 
the chart area does not fill the picture space (see below). 


The basic character size is the fundamental measurement in chart layout. Use of 
CHCGRD can alter the basic proportions of the chart. It is intended to allow charts 
to be drawn in the same proportions on different types of device. 


CHCGRD should be used with care. Normally, the defaults should be used. 
CHCGRD governs: 


¢ Horizontal and vertical size of mode 3 (vector) characters; that is, the basic size 
upon which any multipliers that you use in your program work. 


e The size of the horizontal and vertical margins, and hence the size of the 
plotting area. 


The basic character size is specified in terms of a character grid. The parameters 
specify the number of characters (n) to be accommodated across the width, and 
(m) the number of character rows to be accommodated within the height of the 
chart area. 


The default values correspond to the hardware character size of the primary device 
current at the time of transition from state 1 to state 2 (for example, when n is 80 
and m is 24). If a CHAREA call is issued, this default value is reduced in 
proportion to the ratio of the chart area dimensions to the picture space dimensions 
(horizontal and vertical). 


The physical width and height of the chart margins are affected when n or m, or 
both, differ from the default values. For example, if the default value of n is 80, but 
n is set to 60, the 10-character default width of the vertical margins is physically 4/3 
as wide as the default value, and the physical width of the plotting area is 
correspondingly reduced. 


When initially constructing a chart on a display, to get chart legends and notes 


constructed at the same scale, from one device to another, use a character grid 
unit based on a 24-by-80 screen size. 
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However, if you are initially constructing your chart on a printer (did not use display 
or plotter until chart was done), to get chart legends and notes constructed at the 
same scale, from one device to another, use a character grid unit based upon the 
printer page size. For example, if you are initially constructing your chart for the 
IBM 5225 Printer using 10 cpi, 9 lpi, forms length of 99 and forms width of 132, 
then specify 99-by-132 for character grid units. 


Valid only in state 1. 


Parameters 

n (4-byte binary integer) 
The number of character columns across the width of the chart, which 
determines the basic character width and the size of the vertical margins. If 
zero is specified, the default basic character width is used (see above). 


m (4-byte binary integer) 
The number of character rows in the height of the chart, which determines the 
basic character height and the size of the horizontal margins. If zero is 
specified, the default basic character height is used (see above). 


Coding Example 
The following example shows how to use CHCGRD: 


INTEGER N,M 
LET N = 60 ! Reduce width of the plotting area 
LET M = 0 ! Leave height of the plotting area the default 


CALL GDDM('CHCGRD',N,M) 


Chapter 3. Presentation Graphics Routines 3-17 


CHCOL 


CHCOL-Component Color Table 


CHCOL(count,colors) 


Overrides the default table of color attribute values to be used for data (such as 
lines on line graphs). Colors are taken from this table in turn to construct each 
data group, pie sector, or Venn diagram circle. 


Valid only in state 1. 


Parameters 

count (4-byte binary integer) 
The number of attribute values to be taken from the colors parameter (which is 
an array) and used as the color attribute table. If count is zero, the default 
table is used. The maximum number of values that you can specify is 32. 


colors (array of 4-byte binary integers) 
The color codes to be used consecutively for data groups. 


For valid values of color, see Appendix C, “Colors, Line-Types, Markers, and 
Shading Patterns.” 


Coding Example 
If you wanted the first two data groups (lines on a line graph for example) to be 
green and the third red, you would enter: 


OPTION BASE 1 

INTEGER COLARRAY 

DIM COLARRAY (3) 

MAT READ COLARRAY 

DATA 4,4,2 

CALL GDDM('CHCOL' ,3,COLARRAY ()) 


In this example, 3 is the number of attribute values, 4 means green, and 2 means 
red. 


Note that the table is used cyclically and in this case the fourth data group (if any) 
would be green. 
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CHDATT—Datum Line Attributes 


CHDAT T(count,array) 


Overrides or resets the default attributes used in drawing translated axis lines 
(when used in state 1) or datum lines (when used in state 2). 


The defaults are: 


Color 0 is green on displays, black on printers, highest pen number on 
plotters 

Line type 0 is solid 

Line width 0 is normal 


Valid in state 1 or state 2. 


Parameters 

count (4-byte binary integer) 
The number of elements in the array parameter (which is an array). If more 
than three elements are supplied, the excess elements are ignored. If fewer 
than three are supplied, the remainder are unchanged from their previous 
setting. If the count parameter is set to zero, all defaults are reinstated. 


array (array of 4-byte binary integers) 
The elements of the array are the following attributes: 


1. Color (valid values have the same effect as the GDDM routine GSCOL). 


For valid values of color, see Appendix C, “Colors, Line-Types, Markers, 
and Shading Patterns.” 


2. Line type (valid values have the same effect as the GDDM routine GSLT). 


For valid values of line type, see Appendix C, “Colors, Line-Types, 
Markers, and Shading Patterns.” 


3. Line width (valid values have the same effect as the GDDM routine GSLW). 
Valid values are: 


0 Default (normal) 
1 Normal 
2 Double 


Coding Example 
The following example shows how to use CHDATT to change datum lines to a 
dotted yellow line with normal thickness: 


OPTION BASE 1 

INTEGER ATT 

DIM ATT(3) 

MAT READ ATT 

DATA 6,1,1 

CALL GDDM('CHDATT',3,ATT()) 
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CHDRAX-Specific Control of Axis Drawing 


CHDRAX 


Specifies that the axis lines, scale marks, labels, and associated grid and/or datum 
reference lines are to be constructed immediately, or suppressed. Does not apply 
to axis titles. Note that CHSET (NDRAW) should be used with CHDRAX. 


Valid only when in state 2, after the currently selected axes have been defined by a 
previous call to a plotting routine. 


Parameters 
None 


Coding Example 


The following example shows how to use CHDRAX: 


CALL GDDM('CHSET', 'NDRAW') 
CALL GDDM('CHDRAX') 
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CHFINE-Curve Fitting Smoothness 


CHFINE(smoothness) 


Overrides or resets the default smoothness of the curves used to connect 
consecutive data points in each data group of a line graph or surface chart. 


Note: A parameter value higher than 10 might not add any noticeable degree of 
smoothness to the curve and will increase the time needed by the system to 
draw the chart. 


CHFINE has no effect unless CHSET(CURVE) is explicitly specified, and CHPLOT 
or CHSURF is issued. It also has no effect on a CHPLOT call for which 
CHSET(NOLINES) is specified (that is, a scatter plot). 


The smooth curve joining consecutive pairs of data points is constructed by 
interpolating a number of straight lines between each pair of data points. As the 
number of such interpolated lines increases, the resulting curve appears smoother. 
On higher resolution devices, a larger number of interpolated lines are required to 
give a smooth appearance. CHFINE can be used to control the apparent 
smoothness by specifying the number of interpolated lines. The default number of 
interpolated lines is 10. 


If a nonsolid line type is being used on the display, a smooth curve line may appear 
different from a straight line, in terms of the line-type pattern. 


Valid in state 1 or state 2. 


Parameters 

smoothness (4-byte binary integer) 
The number of straight lines to be constructed between each consecutive pair 
of data points to form the appearance of a smooth curve. Must be 0 through 
1000. 


The default value, which applies if no CHFINE call is issued or if CHFINE(0) is 
issued, is 10. 


Coding Example 
The following example shows how to use CHFINE: 


CALL GDDM('CHSET', 'CURVE') 
CALL GDDM('CHFINE', 20) 
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CHGAP-Spacing between Bars 


CHGAP(gap-to-bar-ratio) 


Overrides the default ratio of the gap between adjacent bars to the bar width. For 
a figure showing the use of CHGAP and CHGGAP, see “CHGGAP-Spacing 
between Bar Groups” on page 3-25. 


The default ratio is half the bar width (0.5). 


Valid in state 1 or state 2. 


Parameters 

gap-to-bar-ratio (short floating-point number) 
The ratio of the gap between bars to the bar width. Gap-to-bar-ratio must be 
between plus and minus one. If zero is specified, the bars have common lines 
that might appear in unexpected colors because of color mixing. 


If gap-to-bar-ratio is a negative number and CHGAP is used before CHBAR, 
the bars in the chart are positioned so that they partially overlap; that is, a bar 
is partially hidden behind the previous one. Values close to —1 are not 
recommended. 


The total length of the axis must accommodate all bars and gaps. As this 
parameter is increased, the actual bar width decreases. It is therefore possible 
to produce bars that appear as single lines. 


Coding Example 
The following example shows how to use CHGAP: 


CALL GDDM('CHGAP' 0.7) 
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CHGATT-Grid Line Attributes 


CHGATT(count,array) 


Overrides or resets the default attributes used in drawing grid lines. 


The defaults are: 


Color 0 is green on displays, black on printers, highest pen number on 
plotters 

Line type 0 is solid 

Line width 0 is normal 


Valid only in state 1. 


Parameters 

count (4-byte binary integer) 
The number of elements in the array parameter. If more than 12 elements are 
specified, the excess elements are ignored. If less than 12 are specified, the 
remainder are unchanged from their previous setting. 


When count is zero, all defaults are reinstated. 


array (array of 4-byte binary integers) 
The attributes for the grid lines. 


The first set of three attributes applies to the primary x axis grid lines, the 
second set applies to the primary y axis grid lines, and the third and fourth sets 
apply to the secondary x and y axis grid lines. The three elements of each set 
are: 


1. Color (except for —1, valid values have the same effect as the GDDM 
routine GSCOL). 


For valid values of color, see Appendix C, “Colors, Line-Types, Markers, 
and Shading Patterns.” 


2. Line type (except for —1, valid values have the same effect as the GDDM 
routine GSLT). 


For valid values of line-type, see Appendix C, “Colors, Line-Types, 
Markers, and Shading Patterns.” 


3. Line width (except for —1, valid values have the same effect as the GDDM 
routine GSLW). Valid values are: 


-1 Leave unchanged 
0 Default (normal) 
1 Normal 
2 Double 
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Coding Example 
The following example shows how to use CHGATT to set up the primary and 
secondary grid lines as green, dotted, normal width lines: 


OPTION BASE 1 

INTEGER ATT 

DIM ATT(6) 

MAT READ ATT 

DATA 4,1,1, 4,1,1 

CALL GDDM('CHGATT',6,ATT()) 
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CHGGAP-Spacing between Bar Groups 


CHGGAP(group-gap-to-bar-ratio) 


For multiple bar charts with more than one data group, CHGGAP overrides the 
default ratio of the gap between bar groups to the width of a single bar. 


The default ratio is twice the bar width (2.0). 


Valid in state 1 or state 2. 


Parameters 

group-gap-to-bar-ratio (short floating-point number) 
The ratio of the gap between bar groups to the width of a single bar. Must be 
positive or zero. 


If this parameter is zero, data groups are drawn with no gap between them. 


The total length of the axis must accommodate all bars and gaps. Therefore, 
as this parameter is increased, the actual bar width decreases. It is thus 
possible to produce bars that appear as single lines. 


Coding Example 
The following example shows how to use CHGGAP: 


CALL GDDM('CHGGAP',1.8) 


In the following chart, the default gap (2.0) is shown: 
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CHHATT-—Heading Text Attributes 


CHHAT T(count, array) 


Overrides or resets the default attributes to be used in the chart heading. 


The defaults are: 


Color 0 (green on displays, black on printers, highest pen 
number on plotters) 

Character mode 3 

Symbol-set identifier 0 (default characters for the device) 


Character size multiplier 100 results in the character size of device unless 
overridden by CHCGRD 


Valid only in state 1. 


Parameters 

count (4-byte binary integer) 
The number of elements in the array parameter. If more than four elements 
are specified, the excess elements are ignored. If fewer than four are 
specified, the remainder are unchanged from their previous setting. 


lf count is zero, all four defaults are reinstated. 


array (array of 4-byte binary integers) 
The elements of the array set the following attributes: 


1. Color (valid values have the same effect as the GDDM routine GSCOL). 


For valid values of color, see Appendix C, “Colors, Line-Types, Markers, 
and Shading Patterns.” 


2. Character mode. 
Valid values are: 


0 System default (mode 3) 
2 Mode 2 
3 Mode 3 


3. Symbol-set identifier. 
For mode 2 or mode 3, the identifier can be: 


0 Default character set 

8 Double-byte character set data (no shift-out or shift-in) 

n A graphics symbol set that has been previously loaded using the 
GDDM routine GSLSS 
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4. Character size multiplier. 


For mode 2 or mode 3, the character size multiplier is divided by 100, and 
the horizontal and vertical spacings or sizes specified by CHCGRD (or its 
defaults) are multiplied by this factor before the characters are drawn. For 
example, if character size multiplier is 200 and mode-3 characters are 
being used, they are drawn twice as large as the basic size, which is that 
of the hardware characters unless overridden by CHCGRD. The character 
size multiplier must have a value greater than zero. 


Coding Example 


The following example shows how to use CHHATT: 


OPTION BASE 1 

INTEGER ARRAY 

DIM ARRAY (4) 

MAT READ ARRAY 

DATA 7,3,65,150 

CALL GDDM('CHHATT',4, ARRAY ()) 


Differences between the System/370 Computer and the AS/400 


System 
On the AS/400 system, character-mode 1 is not supported. 


Chapter 3. Presentation Graphics Routines 3-27 


CHHEAD 


CHHEAD-Heading Text 


CHHEAD (length, text) 


Specifies the chart heading text. CHSET options are available to control its 
occurrence, position, and justification. Its attributes are controlled by CHHATT. 


Valid only in state 1. 


Parameters 

length (4-byte binary integer) 
The length in bytes of the EBCDIC character string supplied. The heading 
length cannot exceed 132 characters. Specifying the length as zero 
suppresses the heading. 


text (character string) 
The chart heading text. The number of characters in the text parameter must 
be the value of the length parameter. 


The character string can be formatted as a number of separate physical lines of 
heading on the chart by the use of the semicolon character (;) as a control 
character, indicating new line. The character string is scanned from left to right, 
and whenever a semicolon control character is found a new line of heading is 
started. The control character itself is not displayed. The lines of heading are 
constructed in turn, each line immediately under the preceding line. Each line 
is subject to separate justification. 


When a semicolon character is required in the heading, two consecutive 
semicolons should be supplied. In this case no new-line action is taken, and 
the two consecutive semicolons cause a single semicolon character to appear 
in the heading. 


Coding Examples 
Example 1: 


In the following example, the heading of a chart is specified to be 'Sample heading’: 
CALL GDDM('CHHEAD',14,'Sample heading') 
Length (14) is the length of the character string 'Sample heading’. 


Example 2: 


In the following example, a two-line heading is specified: 
CALL GDDM('CHHEAD',35,'Line 1 of Heading;Line 2 of Heading') 
It would appear as follows: 


Line 1 of Heading 
Line 2 of Heading 
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CHHIST-Plot a Histogram 


CHHIST(data-groups,count,range1 ,range2,y-values) 


Plots one or more histograms on the currently selected axes. 


The histogram is drawn as a set of bars perpendicular to the x axis. Each bar 
extends over a range defined by a start value and an end value. The ends of the 
bars can be connected to the x axis (or datum reference line) by risers parallel to 
the y axis (see the CHSET option RISERS). The shading method is determined by 
the CHSET shading option. A histogram with more than one data group is plotted 
in a manner similar to a composite bar chart. 


The color of the bars is controlled by the color table, which can be specified by a 
call to CHCOL. The shading patterns are controlled by the shading pattern table, 
which can be specified by a call to CHPAT. 


Valid in state 1 or state 2. If coded in state 1, the program enters state 2. 


Parameters 
data-groups (4-byte binary integer) 
The number of sets of histogram bars to be drawn on the current axes. 


count (4-byte binary integer) 
The number of histogram bars for each data group. 


range! (array of short floating-point numbers) 
Each element in this array gives the start of a range. 


range2 (array of short floating-point numbers) 
Each element in this array gives the end of the range whose start is given by 
the corresponding element of range1. In general, the successive ranges are 
not all equal. If range2 contains the same values as range1 (or is the same 
array) each bar is only as wide as a line. 


y-values (array of short floating-point numbers) 
The dependent values (y-values) used in drawing the histogram. For multiple 
data groups, the values must be stored sequentially by data group; that is, all 
values for the first data group, followed by all values for the second data group, 
and so forth, for as many data groups as specified. 
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Coding Example 
4.00 7 


3.50 


3.00 


0 5 10 15 20 25 30 35 
RV2F749-0 


The following program displays this histogram: 


OPTION BASE 1 

DECIMAL RANGE1,RANGE2, YVALUES 

DIM RANGE1(3), RANGE2(3), YVALUES(3) 

MAT READ RANGE1 

DATA 0,20,25 

MAT READ RANGE2 

DATA 20,25,35 

MAT READ YVALUES 

DATA 1.1,3.2,3.7 

CALL GDDM('CHHIST',1,3,RANGE1() ,RANGE2() , YVALUES()) 
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CHHMAR-Bottom and Top Margins 


CHHMAR(bottom-margin,top-margin) 


Overrides the default margin sizes of the chart, and hence changes the size of the 
plotting area also. The margin sizes are specified in terms of character grid rows 
and character grid columns, where the character grid is that of the device, unless 
explicitly overridden by a call to CHCGRD. 


By default, the horizontal margins are 5 character rows above and below the 
plotting area, and the vertical margins are 10 character columns on each side of 
the plotting area. 


For the left and right margins, see CHVMAR. 


CHHMAR and CHVMAR can enlarge the margins to prevent the legend 
encroaching on the chart plotting area, or reduce the margins to increase the size 
of the chart plotting area. 


Valid only in state 1. 


Parameters 

bottom-margin,top-margin (4-byte binary integers) 
The number of character rows at the bottom and top respectively of the plotting 
area. 


Coding Examples 

In the following example, CHHMAR sets the bottom margin at seven lines above 
the bottom of the plotting area and sets the top margin at five lines below the top of 
the plotting area (which is the default). 


CALL GDDM('CHHMAR',7,5) 
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CHKATT-Legend Text Attributes 


CHKATT(count,array) 


Overrides or resets the default attributes to be used for legend key labels, spider 
labels on pie charts, and Venn diagram labels. For a description of how CHKATT 
applies to pie chart spider labels, see CHSET(SPISECTOR). 


The defaults are: 


Color 0 (green on displays, black on printers, highest pen 
number on plotters) 

Character mode 3 

Symbol-set identifier 0 (default characters for the device) 


Character size multiplier 100 (text size is defined by CHCGRD; by default the 


Valid 


size of hardware characters) 


only in state 1. 


Parameters 


coun 


t (4-byte binary integer) 


The number of elements in the array parameter. If more than four elements 


a 


re specified, the excess elements are ignored. If fewer than four are 


specified, the remainder are unchanged from their previous setting. 


If 


array 
r 


count is zero, all four defaults are reinstated. 


(array of 4-byte binary integers) 
he elements of the array set the following attributes: 


1. Color (valid values have the same effect as the GDDM routine GSCOL). 


For valid values of color, see Appendix C, “Colors, Line-Types, Markers, 
and Shading Patterns.” 


If the device does not support one or more of these colors, a 
device-dependent alternative is chosen. 


2. Character mode. 


Valid values are: 


0 System default (mode 3) 
2 Mode 2 
3 Mode 3 


3. Symbol-set identifier. 
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For mode 2 or mode 38, the identifier can be: 


0 Default character set 
8 Double-byte character set data (no shift-out or shift-in) 
n A graphics symbol set that has been previously loaded using GSLSS 


CHKATT 


4. Character size multiplier. 


For mode 2 or mode 3, the character size multiplier is divided by 100, and 
the horizontal and vertical spacings or sizes specified by CHCGRD (or its 
defaults) are multiplied by this factor before the characters are drawn. For 
example, if character size multiplier is 200 and mode 3 characters are 
being used, they are drawn twice as large as the basic size set by 
CHCGRD. The character size multiplier must have a value greater than 
zero. 


Coding Examples 

In the following example, CHKATT sets the character attributes of labels as blue, 
mode 3 characters from symbol set 65 as loaded by GSLSS, drawn one and a half 
times as large as the basic character size specified by CHCGRD. 


OPTION BASE 1 

INTEGER ATTARR 

DIM ATTAR(4) 

MAT READ ATTARR 

DATA 1,3,65,125 

CALL GDDM('CHKATT',4,ATTARR()) 


Differences between the System/370 Computer and the AS/400 


System 
On the AS/400 system, character mode 1 is not supported. 
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CHKEY-Legend Key Labels 


CHKEY(count,length, labels) 


Specifies legend key labels for data groups (on a line graph, surface chart, bar 
chart, histogram) or for pie chart sectors. Also has other interpretations for pie 
charts and Venn diagrams, as follows: 


e For pie charts, the labels specified by CHKEY appear as sector labels around 
each pie if CHSET(SPIDER) is specified; they appear instead as key labels in a 
legend only if CHSET(PIEKEY) is specified. 


e For Venn diagrams, the labels specified by CHKEY appear as labels connected 
to the Venn circles and their overlap. Only the first three labels are used. No 
legend can be specified for a Venn diagram. 


In all cases (legend key labels, pie sector labels, and Venn diagram labels), the 
labels are constructed with the attributes specified by CHKATT, or with the 
CHKATT default attribute values. 


For keys in a legend, on each plotting routine call, a key is created for each data 
group or pie sector plotted using the supplied labels in sequence. Thus, if more 
labels are provided than are needed for the number of data groups or sectors 
plotted, the remaining labels are ignored. If fewer labels are provided than are 
needed, the number of keys constructed is equal to the number of labels supplied. 
In all cases, legend base position justification (see CHKEYP) is based on the 
assumption that all labels provided are generated. Thus, if all labels are not used, 
the legend might not be where you expect it. 


If no CHKEY call is issued, then no legend is constructed. Even if a CHKEY call is 
issued, a legend is constructed only if CHSET(LEGEND) applies (and, in the case 
of pie charts, only if CHSET(PIEKEY) applies also). 


Valid only in state 1. 


Parameters 

count (4-byte binary integer) 
The number of labels supplied in the labels parameter. Count is 0 can be 
useful for deleting labels defined by a previous CHKEY call. 


length (4-byte binary integer) 
The number of characters in each label supplied in the labels parameter. All 
labels supplied have the same length. The effect of varying length labels can 
be produced by padding each label with null (X' 00') characters. All such 
trailing nulls are ignored when the legend is constructed. 


If a label consists entirely of null characters, the associated legend key label or 
Venn diagram label is not constructed. For pie sector labels, the sector label 
and associated spider line connecting it to the pie sector are not constructed 
(unless CHSET(VALUES) is specified, when the value and associated 
connecting line are constructed). 


labels (character string) 
A list of labels each as long as the value of the length parameter. The total 
length, L, of the text string that is seen is given, in bytes, by: 
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L = count*length 
The maximum value of L permitted is approximately 32,000. 


Semicolons (;) and underscores (_) in each label are interpreted specially when 
the labels appear in legends. A semicolon causes a line break: a new line in 
the legend is started, left-justified. An underscore causes the key symbol to be 
drawn at that point (taking up 3 key label character positions). 


Specifying ;; causes a semicolon to appear in the label, without a line break. 
Similarly, specifying __ (two underscores) causes an underscore to appear in 
the label, without substituting a key symbol. 


If a legend key label contains no underscore control characters, a key symbol 
followed by a blank character (the whole occupying 4 character positions) is 
constructed at the start of the first line of the key label. Any further lines of the 
key label are indented 4 character positions to align with the text of the first 
line. If a legend key label contains one or more underscore control characters, 
key symbols (each occupying three character positions) are constructed where 
underscore control characters appear. No indenting of lines occurs. 


In sector labels on pie charts, single semicolon characters are interpreted as 
line break control characters as described above, and single underscore 
characters are interpreted as blanks. In Venn diagram labels, both semicolon 
and underscore single characters are interpreted as blanks. In both pie sector 
labels and Venn diagram labels, ;; appears as ; and __ (two underscores) 
appear as _ when drawn. 


The following character codes also have special interpretations: 


e¢ X'15' is interpreted as a line break control character. 


e X'1A' is interpreted as a key symbol substitution control character. 


In BASIC, you cannot directly specify how to set bits on and off but you can 
use the HEX¢$ built-in function. In RPG Ill, you could use the BITON and 
BITOFF operation codes; in PL/I, you could use BIT data; in COBOL, there is 
no direct way of manipulating bit strings; you might want to call a program in 
another language, passing the other program a character string to be initialized 
and returned with the correct bit values. For an example of coding X'15' ina 
BASIC program, see the GDDM call GSCHAP (where X'15' also acts as a line 
break control character). 


Coding Examples 


The following example shows how to specify CHKEY: 
CALL GDDM('CHKEY',2,19,'This Label is Long;Short Label ') 
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CHKEYP-Legend Base Position 


CHKEYP(orientation,margin, justification) 


Overrides the default base position of the legend. The legend offsets (0 by default, 
see CHKOFF) are applied to the base position to obtain the legend final position. 
The legend base position also affects many aspects of the legend format. The 
default base position, which applies when CHKEYP is not called, specifies a 
vertical legend centered in the right margin. 


Valid only in state 1. 


Parameters 
orientation (character string) 
A character string of length 1 containing V or H. 


V specifies a vertical legend (base position in the left or right margin, adjacent 
to the left or right chart area boundary). 


H specifies a horizontal legend (base position in the top or bottom margin, 
adjacent to the top or bottom chart area boundary). 


margin (character string) 
A character string of length 1 containing R, L, T, or B. 


R and L specify a base position in the right and left margins respectively and 
are valid only for vertical legends. 


T and B specify a base position in the top and bottom margins respectively and 
are valid only for horizontal legends. 


justification (character string) 
A character string of length 1 containing C, R, L, T, or B. 


C specifies a base position centered in the margin and is valid for both 
horizontal and vertical legends. 


R and L specify right and left justification, and are valid only for horizontal 
legends. For example, L specifies that the legend is justified to the left of the 
top or bottom margin. 


T and B specify top and bottom justification, and are valid only for vertical 
legends. For example, T specifies that the legend is justified to the top of the 
left or right margin. 


Coding Examples 
The following example shows how to specify CHKEYP: 


CALL GDDM('CHKEYP','H','B','C') 
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CHKMAX-—Maximum Legend Width/Height 


CHKMAX(hmax,vmax) 


Specifies the maximum width of a horizontal legend and the maximum height of a 
vertical legend. 


Both parameters are 4-byte binary integers. Their values must not be negative. 
The units are the character width and height, which default to the hardware 
character size unless the defaults are explicitly overridden by CHCGRD. 


Zero specifies that the legend height or width is limited by the height or width of the 
chart area. 


Valid only in state 1. 


Parameters 

hmax (4-byte binary integer) 
The maximum width of a horizontal legend. As many key entries are 
constructed in each row of the legend as is possible, given the maximum width 
specified (except that the first key entry in each row is always constructed, 
even if it is wider than the maximum width specified). 


When the maximum width would be exceeded by a new entry, a new line is 
started. 


A zero value specifies that the full chart area width is to be used. 


If the value specified results in a maximum legend width greater than the chart 
area width, the chart area width is used as the maximum. 


Each line of a key entry begins and ends with a blank character (for spacing). 
Therefore the width of a key entry is: 


2 plus the number of character positions in longest line of key entry 


The maximum legend width specified applies to the actual width including these 
2 extra spacing characters for each key entry. 


vmax (4-byte binary integer) 
The maximum height of a vertical legend. As many key entries are constructed 
in each column of the legend as is possible given the maximum height 
specified (except that the first key entry in each column is always constructed, 
even if it is taller than the maximum height specified). When the maximum 
height would be exceeded by a new entry, a new column is started. 


A zero value specifies that the full chart area height is to be used. 


If the value specified results in a maximum legend height greater than the chart 
area height, the chart area height is used as the maximum. 
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The top line of text in a key entry begins a half-character height below the top 
of the space occupied by the key entry. Similarly there is a half-character 
height between the bottom line of a key entry and the bottom of the space 
occupied by the key entry. Therefore the height of a key entry is: 


1 plus the number of lines in key entry 


The maximum legend height specified applies to the actual height including this 
extra spacing character for each key entry. 


Coding Examples 
The following example shows how to specify CHKMAX: 


! When the label is as follows: 

CALL GDDM('CHKEY',2,18,'This Label is Long;Short Label ') 
! You can specify CHKMAX as follows so that one label appears 
! on a line: 

CALL GDDM('CHKMAX', 18,4) 
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CHKOFF-Legend Offsets 


CHKOFF (horizontal-offset,vertical-offset) 


Specifies the horizontal and vertical offsets, interpreted in character grid units, 
which are used to obtain the final legend position from the legend base position. 
Character grid units are the character size of the device unless explicitly overridden 
by a call to CHCGRD. 


If no CHKOFF call is issued, no offsets are applied. 


When the legend is constructed, it is formatted in the legend base position, then 
translated across the chart area by the specified horizontal and vertical offsets. If, 
as a result, any part of the legend lies outside the chart area, the legend is further 
translated horizontally and/or vertically as necessary until it lies just within the 
nearest chart area boundaries. 


Valid only in state 1. 


Parameters 

horizontal-offset (short floating-point number) 
The horizontal offset, in character grid units (which default to the character size 
of the device unless explicitly overridden by a call to CHCGRD) to be applied to 
the legend base position. A positive value specifies translation to the right, and 
a negative value translation to the left. 


vertical-offset (short floating-point number) 
The vertical offset, in character grid units (which default to the character size of 
the device unless explicitly overridden by a call to CHCGRD) to be applied to 
the legend base position. A positive value specifies upward translation, and a 
negative value downward translation. 


Coding Examples 

The following example shows how to specify CHKOFF: 
! When the label position is in the right margin, for example: 
CALL GDDM('CHKEYP','V','R','T') 
! You can choose to offset the legend closer to the bottom: 
CALL GDDM('CHKOFF',0,2) 
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CHLATT-—Axis Label Text Attributes 


CHLATT(count,array) 


Overrides or reestablishes the default character-appearance attributes used in 
displaying a// axis labels, and pie titles (on pie charts) on all the axes. You can use 
the CHXLAT, and CHYLAT calls to change the axis label attributes for the currently 
selected x, or y axis. 


By default, the attributes are as follows: 


Color 0 (green on displays, black on printers, highest 
pen number on plotters) 

Character mode 3 

Symbol-set identifier 0 (system default) 

Character-size multiplier 100 (results in the text size as defined by 
CHCGRD (by default, the size of the hardware 
characters) 


Character height/width multiplier 100 (results in the text size as defined by 
CHCGRD (by default, the size of the hardware 
characters) unless overridden by CHXLAT) 


Label rotation 0 


Valid only in state 1. 


Parameters 

count (4-byte binary integer) 
Specifies the number of elements in array. If more than six elements are 
specified, the excess elements are ignored. If fewer than six, the remainder 
are unchanged from their previous setting. If zero is specified, all six defaults 
are reinstated. 


array (an array of 4-byte binary integers) 
An array of, at most, six 4-byte binary integers: 


1. Color. 


For valid values of color, see Appendix C, “Colors, Line-Types, Markers, 
and Shading Patterns.” 


2. Character mode. 
Valid values are: 


0 system default (mode 3) 
2 mode 2 
3 mode 3 
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3. Symbol-set identifier. 
For mode 2 or mode 3, the identifier denotes: 


0 the default character set 

8 Double-byte character set data (no shift-out or shift-in) 

n a graphics symbol set that has been previously loaded into GDDM by 
the application program using the GDDM call GSLSS 


4. Character-size multiplier. 


For modes 2 and 3, the character-size multiplier is divided by 100, and the 
horizontal and vertical spacings or sizes specified by CHCGRD (or its 
defaults) are multiplied by this factor before the characters are drawn. For 
example, if character-size multiplier is 200 and mode 3 characters are 
being used, they are drawn twice as large as the basic size set by 
CHCGRD. The character-size multiplier must have a value greater than 
zero. 


5. Character height/width multiplier. 


Specifies the height of the character box relative to its width. For example, 
100 indicates that the height is multiplied by the same amount as the width. 
200 causes the height to be multiplied by twice the amount of the width. 


6. Axis-label rotation. 


When axis label rotation is requested, each label is written at the specified 
angle to the horizontal. Label rotation is indicated by specifying a nonzero 
value in this element. The value must be between —9000 and +9000. This 
number is divided by 100 to give a value between —90 and +90, which is 
the angle, in degrees, to the horizontal at which the labels will be drawn. 
The default is zero. When positive, the angle is in a counterclockwise 
direction. When negative, it is in a clockwise direction. 


Coding Examples 

In the following example, CHLATT sets the character attributes of axis labels as 
blue, mode 3 characters from symbol set 65 as loaded by GSLSS, drawn one and 
a half times as large as the basic character size specified by CHCGRD. 


OPTION BASE 1 

INTEGER ATTARR 

DIM ATTAR(4) 

MAT READ ATTAR 

DATA 1,3,65,150 

CALL GDDM('CHLATT',4,ATTARR()) 


Differences between the System/370 Computer and the AS/400 


System 
On the AS/400 system, character mode 1 is not supported. 
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CHLT—Component Line Type Table 


CHLT(count,line-types) 


Overrides or resets the default table of line type attributes. Line type attributes are 
taken in sequence from the table and used for each data group, pie sector, or Venn 
diagram circle. 


The default table has only one entry: 
Index Line type 
1 1 (solid) 


Valid only in state 1. 


Parameters 

count (4-byte binary integer) 
The number of attribute values to be taken from the line-types parameter and 
used as the line type attribute table. If count is zero, the default table is used. 
A maximum of 32 values can be specified. 


line-types (array of 4-byte binary integers) 
The line types to be used consecutively for data groups. 


For valid values of line types, see Appendix C, “Colors, Line-Types, Markers, 
and Shading Patterns.” 


Coding Examples 
In the following example, CHLT sets up a table of three line types: dot, short-dash, 
and dash-dot. 


OPTION BASE 1 

INTEGER LINTYPS 

DIM LINTYPS (3) 

MAT READ LINTYPS 

DATA 1,2,3 

CALL GDDM('CHLT',3,LINTYPS()) 
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CHLW-Component Line Width Table 


CHLW(count,line-widths) 


Overrides or resets the default table of line width attributes. Line width attributes 
are taken in turn from the table and used for each data group, pie sector, or Venn 
diagram circle. 


The default table has only one entry: 
Index Line width 
1 1.0 


Valid only in state 1. 


Parameters 

count (4-byte binary integer) 
The number of attribute values to be taken from the line-widths parameter 
(which is an array) and used as the line width attribute table. If count is zero, 
the default table is used. A maximum of 32 values can be specified. 


line-widths (array of short floating-point numbers) 
The line widths to be used consecutively for data groups. Valid values are 0 
through 100. 


The specified value is a multiplication factor to be applied to the standard line 
width, shown below. The standard width is multiplied by the specified factor, 
and then rounded down to an integral number of pixels. If the result is less 
than one pixel, a width of one pixel is used. If the result is more than the 
maximum shown below, the maximum is used. 


Minimum Standard Maximum 
Device (Value is 0) (Value is 1) (Value is 100) 
5292 Model 2 1 1 2 
IBM PCs 1 1 1 
IBM plotters 1 1 1 
Printers 1 1 2 


Coding Examples 
In the following example, CHLW sets up a table of three line widths: the standard 
width, one and a half times the standard width, and twice the standard width. 


OPTION BASE 1 

DECIMAL LINWIDS 

DIM LINWIDS (3) 

MAT READ LINWIDS 

DATA 1.0,1.5,2.0 

CALL GDDM('CHLW',3,LINWIDS()) 
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CHMARK-—Component Marker Table 


CHMARK(count,markers) 


Overrides or resets the default table of marker values. Markers from this table are 
used in sequence to construct each data group. 


Valid only in state 1. 


Parameters 

count (4-byte binary integer) 
The number of attribute values to be taken from the markers parameter (which 
is an array) and used as the marker attribute table. If count is zero, the default 
table is used. A maximum of 32 values can be specified. 


markers (array of 4-byte binary integers) 
The marker values to be used consecutively for data groups. The default is 0 
(a cross; Same as marker symbol 1). For valid values of markers, see 
Appendix C, “Colors, Line-Types, Markers, and Shading Patterns.” 


Coding Examples 
In the following example, CHMARK sets up a table of three markers to be used 
consecutively for data groups: cross, diamond, and square. 


OPTION BASE 1 

INTEGER MARKERS 

DIM MARKERS (3) 

MAT READ MARKERS 

DATA 1,3,4 

CALL GDDM('CHMARK',3,MARKERS ()) 
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CHNATT-Specify Attributes for Notes 


CHNATT(count,array) 


Overrides or reestablishes the default character attributes used for notes. 


The defaults are: 


Color 0 (green on displays, black on printers, highest 
pen number on plotters) 

Character mode 3 

Symbol-set identifier 0 (system default) 

Character-size multiplier 100 (text size as defined by CHCGRD (by 


default, the size of the hardware characters)) 


Character height/width multiplier 100 (text size as defined by CHCGRD (by 
default, the size of the hardware characters)) 


Note rotation 0 


Valid in state 1 or state 2. 


Parameters 

count (4-byte binary integer) 
A 4-byte binary integer specifying the number of elements in array. If more 
than six elements are specified, the excess elements are ignored. If fewer than 
six, the remainder are unchanged from their previous setting. If zero is 
specified, all six defaults are reinstated. 


array (an array of 4-byte binary integers) 
An array of, at most, six 4-byte binary integers: 


1. Color. 


For valid values of color, see Appendix C, “Colors, Line-Types, Markers, 
and Shading Patterns.” 


2. Character mode. 
Valid values are: 


0 system default (mode 3) 
2 mode 2 
3 mode 3 


3. Symbol-set identifier. 
For mode 2 or mode 3, the identifier denotes: 


0 the default character set 

8 Double-byte character set data (no shift-out or shift-in) 

n a graphics symbol set that has been previously loaded into GDDM by 
the application program using the GDDM call GSLSS 
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4. Character-size multiplier. 


For modes 2 and 3, the character-size multiplier is divided by 100, and the 
horizontal and vertical spacings or sizes specified by CHCGRD (or its 
defaults) are multiplied by this factor before the characters are drawn. 
(CHCGRD defaults are the size of characters for the device.) For example, 
if character-size multiplier = 200 and mode 3 characters are being used, 
they are drawn twice as large as the hardware characters unless CHCGRD 
has been used to override the default. The character-size multiplier must 
have a value greater than zero. 


. Character height/width multiplier. 


Specifies the height of the character box relative to its width. For example, 
100 indicates that the height is multiplied by the same amount as the width. 
200 causes the height to be multiplied by twice the amount of the width. 


. Note rotation. 


Note rotation is indicated by specifying a nonzero value in this element. 
When note rotation is requested, each note is written at the specified angle 
to the horizontal. The value must be between —36000 and +36000. This 
number is divided by 100 to give a value between —360 and +360, which is 
the angle, in degrees, to the horizontal at which the notes are drawn. The 
default is zero. When positive, the angle is in a counterclockwise direction. 
When negative, it is in a clockwise direction. 


The rotation occurs when the note is drawn (that is, wnen CHNOTE is 
called). The rotation is performed so that the part of the imaginary 
rectangle surrounding the note (as specified in CHNOTE) remains at the 
offset specified in CHNOFF. 


When mode-2 characters are used, the area that is blanked (if blanking is 
specified) or the surrounding box (if boxing is specified) may not surround 
the note but might cut through some of the characters. This is because of 
the inherent characteristics of mode-2 text. 


Note rotation is not supported for class 2 position codes (see CHNOTE). 


Coding Examples 

In the following example, CHNATT sets the character attributes of notes as blue, 
mode 3 characters from symbol set 65 as loaded by GSLSS, drawn one and a half 
times as large as the basic character size specified by CHCGRD. 


OPTION BASE 1 

INTEGER ATTARR 

DIM ATTAR(4) 

MAT READ ATTAR 

DATA 1,3,65,150 

CALL GDDM('CHNATT',4,ATTARR()) 


Differences between the System/370 Computer and the AS/400 
System 
On the AS/400 system, character mode 1 is not supported. 


3-46 AS/400 GDDM Reference 


CHNOFF 


CHNOFF-Specify Offsets for CHNOTE 


CHNOFF (horizontal-offset,vertical-offset) 


Specifies the offsets to be applied to the base position of the note to obtain the 
note position (see CHNOTE). Applies to all subsequent calls to CHNOTE (until 
superseded by another CHNOFF call). If CHNOFF is not called, no offset is 
applied to the note. 


Valid in state 1 or state 2. 


Parameters 

horizontal-offset (signed, short floating-point number) 
The horizontal offset to be applied to the note. Depending on the CHNOTE 
position code, the offset can be interpreted in two ways: 


e As an offset in character grid units. A positive number specifies movement 
to the right, and a negative number movement to the left. 


The size of character grid units defaults to the character size of the device, 
but can be altered by a CHCGRD call. 


e As an offset in scale units of the currently selected horizontal axis. The 
(positive or negative) number specifies movement from the base position 
(the axis origin (0)) to the axis position given by the number. (The offset 
must be positive for a logarithmic axis.) 


The default value is zero. 


vertical-offset (signed, short floating-point number) 
The vertical offset to be applied to the note base position. Depending on the 
CHNOTE position code, the offset can be interpreted in two ways: 


¢ As an offset in character grid units. A positive number specifies upward 
movement, and a negative number downward movement. The size of 
character grid units defaults to the character size of the device, but can be 
altered by a CHCGRD call. 


¢ As an offset in scale units of the currently selected vertical axis. The 
(positive or negative) number specifies movement from the base position 
(the axis origin (0)) to the axis position given by the number. (The offset 
must be positive for a logarithmic axis.) 


The default value is zero. 
Coding Examples 


In the following example, CHNOFF offsets notes by 2 character-grid positions to the 
right: 


CALL GDDM('CHNOFF',2.0,0.0) 
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CHNOTE-Construct a Character String at a Designated Position 


CHNOTE (position-code,length,string) 


This call is valid only in state 2. It constructs a character string (a note) ata 
designated location on the chart. 


The position of the note is adjusted by the offsets specified by the most recent 
CHNOFF call. The note text attributes are those specified by the most recent 
CHNATT call. If no CHNOFF or CHNATT call has been issued, defaults apply for 
offsets and text attributes, as described under CHNOFF and CHNATT. 


The final position of the note on the chart is determined from the position code in 
the following way. The position code specifies a base position within the chart 
area. Horizontal and vertical note offsets are then added algebraically to the base 
position to obtain the note position. Finally, depending on the position code, the 
note can be relocated relative to the note position to obtain its final position, where 
it is constructed. 


Position codes fall into two mutually exclusive classes. Class 1 codes support 
multiple-line notes, rectangular boxing around the note, note rotation, and relocation 
relative to the note position. Class 2 supports none of these, and is provided 
mainly for compatibility with early releases of System/370 GDDM-PGF. 


The CHSET call option BNOT can be used with position codes of both classes to 
blank the rectangular area occupied by the characters of the note, before note 
construction. 
Some examples of the use of CHNOTE are: 

¢ To annotate individual plotted points, lines, or areas on a chart. 

¢ To provide a subheading in a different font from the main heading. 

¢ To provide a footnote on a chart. 


¢ To extend the basic axis annotation functions (labels and titles) where required. 
For example, multiple-line axis titles or labels can be constructed as notes. 
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Parameters 

position-code (character string) 
A 2-character code indicating the manner in which the final position of the note 
is determined in terms of a base position, note position, and relocation relative 
to the note position. As stated above, position codes are divided into two 
classes: 


¢ Class 1 position codes 


This class contains the following 36 position codes: 


C1, C2, C3, C4, C5, C6, C7, C8, C9 
H1, H2, H3, H4, H5, H6, H7, H8, H9 
V1, V2, V3, V4, V5, V6, V7, V8, V9 
Z1, 22, Z3, Z4, Z5, Z6, Z7, 28, 29 


The first character of each code is interpreted as follows: 


C__ The base position is the bottom left corner of the chart area. Both 
horizontal and vertical CHNOFF note offsets are interpreted in 
character grid units from the base position to obtain the note position. 


H__ The horizontal CHNOFF note offset is interpreted in units of the scale 
of the currently selected horizontal axis from the base position given 
by the origin (0) on that axis (even when the origin is outside the 
range of that axis). The vertical CHNOFF note offset is interpreted in 
character grid units from the base position given by the bottom of the 
chart area. 


V____ The vertical CHNOFF note offset is interpreted in units of the scale of 
the currently selected vertical axis from the base position given by the 
origin (0) on that axis (even when the origin is outside the range of 
that axis). The horizontal CHNOFF note offset is interpreted in 
character grid units from the base position given by the left of the 
chart area. 


Z The horizontal CHNOFF note offset is interpreted as for H above, and 
the vertical CHNOFF note offset is interpreted as for V above. 


The second character of each class 1 position code specifies the relocation 
that takes place from the note position to obtain the final position of the 
note. It is a number in the range 1 through 9, which might be thought of as 
a compass key defining the point of the note that is to be fixed at the note 
position. The numbers correspond to the corners and mid-points of an 
imaginary rectangle just surrounding all the characters of the note (the note 
rectangle), as follows: 


1 2 3 
4 5 6 
vA 8 9 


For example, number 1 relocates the note to place its top left corner at the 
note position, number 7 places the bottom left corner of the note at the 
note position, number 6 places the mid-point of the right side of the note at 
the note position, and so on. 
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Control=1 Control=3 


>Baseline x >Baseline 


Control=2 
SP 


x >Baseline x >Baseline 


SP = start point 
EP = end point 


Position codes beginning with H, V, or Z are only valid for notes on charts 
with axes (that is, for all chart types except pie charts and Venn diagrams). 
Further, for these position codes, any axis used for interpretation of note 
offsets must be defined when the CHNOTE call is issued. Finally, for these 
position codes, if an axis offset determines a note position outside the 
range of the corresponding axis, the note is not constructed (no diagnostic 
is issued in this case). 


For position codes beginning with H, V, or Z, and with the second compass 
key character being any value except 5, the final position of the note is 
adjusted by a slight amount in the direction of each axis used for 
interpretation of note offsets. This should provide acceptable positioning in 
typical cases where the note is used to annotate a particular point on a 
chart (such as a marker), using as axis offsets the x or y values of the 
marker. 


For all class 1 position codes, semicolon (;) characters within the note text 
are interpreted as line break control characters. This facility allows 
multiple-line notes to be constructed easily. For example the following note 
text: 


Thissnote; is a;multiple-line;note. 


CHNOTE 


is constructed so as to appear on the chart as: 
This 
note 
is a 
multiple-line 
note. 


When a semicolon is needed in the text on the chart, two contiguous 
semicolon characters must be supplied in the note text. These do not 
cause line breaks, and each such contiguous pair found during a 
start-to-end scan of the note text is replaced by a single semicolon 
character in the constructed note. 


For all class 1 position codes, when the CHSET call option NBOX is 
specified, the note is surrounded by a rectangular framing box, constructed 
of lines with default line type (solid), default line thickness (normal 
thickness), and line color the same as the color of the note text (specified 
by CHNATT). 


For all class 1 position codes, any trailing nulls in the note text string are 
ignored, and do not contribute to the constructed note or its position. 


If any part of the note rectangle (including any framing box) lies outside the 
chart area, the entire note rectangle is moved horizontally and/or vertically 

until it lies within the chart area. An error diagnostic is produced only if the 
note rectangle, after this translation, is too wide or too high to be contained 
entirely within the chart area. 


Class 2 position codes 


This class contains nine position codes. Each code is associated with a 
base position as follows: 


TL The top left point of the string is at the top left point of the chart area. 


TC The top center point of the string is at the top center point of the chart 
area. 


TR The top right point of the string is at the top right point of the chart 
area. 


BL_ The bottom left point of the string is at the bottom left point of the 
chart area. 


BC The bottom center point of the string is at the bottom center point of 
the chart area. 


BR_ The bottom right point of the string is at the bottom right point of the 
chart area. 


DL_ The bottom left point of the string is at the left end of a horizontal 
datum line (specified using CHYDTM), or at the bottom end of a 
vertical datum line (specified using CHXDTM). 


DC The bottom center point of the string is at the mid-point of a horizontal 
datum line (specified using CHYDTM), or the left center point of the 
string is at the mid-point of a vertical datum line (specified using 
CHXDTM). 


DR_ The bottom right point of the string is at the right end of a horizontal 
datum line (specified using CHYDTM), or the top left point of the 
string is at the top of a vertical datum line (specified using CHXDTM). 
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Position codes beginning with D refer to datum lines or translated axis lines 
currently selected when CHNOTE is called. The particular line to be 
annotated is determined as follows: 


— If calls have been made to CHXDTM or CHYDTM in state 2 before 
CHNOTE is called, the most recent of such calls is used. 


— If there have been no calls to CHXDTM or CHYDTM in state 2 
preceding CHNOTE, the most recent state 1 call to CHYDTM (if any) is 
used. If CHYDTM has not been called, an error message is issued. 
Any call to CHXDTM in state 1 cannot be implicitly referred to in this 
manner. 


For all class 2 position codes, the note position is obtained from the base 
position by applying CHNOFF note offsets, interpreted in character grid 
units. 


For class 2 position codes, semicolons are never interpreted as line break 
control characters, and a note framing box is never constructed. 


If the note position is not related to a datum line or translated axis line, and 
the position after adjusting for offsets lies outside the chart area, the note is 
drawn justified to the chart area boundary. No error or warning message is 
issued unless the note is too large to fit into the chart area. 


length (4-byte binary integer) 
The number of characters in the string parameter. 


string (character string) 
The character string to be constructed on the chart. (Depending on the 
position code, semicolon characters in the string might be interpreted as line 
break control characters.) 
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Coding Examples 
Specifying CHNOTE as follows causes the note to appear as shown in the sample 
shown below. 


DECIMAL XVALUES, YVALUES 

DIM XVALUES (5) 

MAT READ XVALUES 

DATA 0.0, 1.0, 2.0, 3.0, 4.0 

DIM YVALUES (5) 

MAT READ YVALUES 

DATA 2.0, 2.0, 2.5, 1.0, 1.0 

CALL GDDM('CHPLOT',1,5,XVALUES() , YVALUES()) 

CALL GDDM('CHNOFF',2.0,2.5) ! Third point on graph 
CALL GDDM('CHNOTE','Z7',23,'Note line 1;note line 2') 


The note in this example appears as: 


Note line 1 
note line 2 
2.50 7 


2.00 


1.50 7 


0.00 I | | 


0.00 0.50 1.00 1.50 2.00 2.50 3.00 3.50 4.00 
RV2F750-0 
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CHNUM-Set Number of Components 


CHNUM(n) 


Sets the total number of pie charts or multiple bar charts to be constructed by 
subsequent calls to CHPIE and CHBAR. Controls spacing and size of the pies 
(and bars) so that the complete chart fits within the plotting area. Should be used 
for multiple pie charts, and multiple bar charts, whenever they are to be constructed 
by more than one plotting call. 


Valid only in state 1. 


Parameters 

n (4-byte binary integer) 
The total number of charts to be drawn. If n is set to zero, or if no call is made, 
the number of pies is determined from the first subsequent call to CHPIE. 


Coding Examples 
In the following example, three charts are to be drawn: 


CALL GDDM('CHNUM' ,3) 
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CHPAT-—Component Shading Pattern Table 


CHPAT(count,patterns) 


Overrides or resets the default table of shading pattern values to be used. Patterns 
from the table are used in turn to construct each data group, pie sector, or Venn 
diagram circle. 


If CHPAT is not specified, the first eight of the 16 patterns shown in the default 
pattern table are used in drawing shaded components. If CHPAT is specified, all 
16 patterns are used in drawing shaded components. 


Valid only in state 1. 


Parameters 

count (4-byte binary integer) 
The number of attribute values to be taken from the patterns array and used as 
the shading pattern attribute table. If count is zero, the default table is used. A 
maximum of 32 values can be specified. 


patterns (array of 4-byte binary integers) 
The pattern codes to be used consecutively for data groups. 


For valid pattern values, see Appendix C, “Colors, Line-Types, Markers, and 
Shading Patterns.” 


Coding Examples 
In the following example, three patterns are used to draw charts. 


OPTION BASE 1 

INTEGER PATARR 

DIM PATARR(3) 

MAT READ PATARR 

DATA 2,8,3 

CALL GDDM('CHPAT',3,PATARR()) 


Differences between the System/370 Computer and the AS/400 
System 

On the AS/400 system, user-defined patterns are not supported, (types 65 through 
239). 
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CHPCTL-Control Pie Chart Slices 


CHPCTL(count,list) 


Controls how the slices of a pie chart are displayed. The call operates on exploded 
slices (those that have been moved out from the rest of the pie, see CHPEXP) and 
non-exploded slices. 


Valid only in state 1. 


Parameters 

count (4-byte binary integer) 
Specifies the number of items in the list array. The value must be in the range 
0 through 1. If 0 is specified, default values are used for the option. 


list (array of short floating-point numbers) 
Controls the option for the slices of a pie chart. If the list does not contain a 
value, the option is not changed. The option is: 


Explode Defines the amount, in terms of a multiple of the horizontal radius, 
by which exploded slices are moved out. For example, when a 
value of 0.5 is specified, the tip of each exploded slice is moved out 
to halfway between the center of the pie and its circumference. The 
horizontal radius of the pie is reduced as necessary to ensure that 
the entire pie remains within the plotting area. Values greater than 
1 make the slices of the pie small and difficult to see. The default is 
0.2. 


Coding Examples 
The following example shows how to use CHPCTL to move the tip of a slice to 
halfway between the center and circumference of a pie. 


OPTION BASE 1 

DECIMAL LARR 

DIM LARR(1) 

MAT READ LARR 

DATA 0.5 

CALL GDDM('CHPCTL',1,LARR()) 


Differences between System/38 and the AS/400 System 
This call is not supported on System/38. 
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CHPEXP-Exploded Slices in Pie Charts 


CHPEXP(count,list) 


Specifies which slices of a pie chart are to be exploded (moved out from the other 
slices of the pie). The CHPCTL call (see page 3-56) controls the amount by which 
the slice is to be moved. 


Valid only in state 1. 


Parameters 

count (4-byte binary integer) 
Specifies the number of items contained in the list array. The value must be in 
the range 0 through 32. If 0 is specified, a default explosion array is restored. 


list (an array of 4-byte binary integers) 
Elements in this array correspond to slices of the pie. If there is more than one 
pie, the elements correspond to the equivalent slice of each pie. An element 
that contains 1 indicates that the corresponding slice of the pie is moved. An 
element that contains 0 indicates that the corresponding slice of the pie is not 
moved. Only 0 and 1 can be specified in this parameter. 


If the length of the list does not match the number of slices in the pie, the list is 
truncated (if it is too long) or resumes from the start (if it is too short). 


The default list array contains all zero values, which causes none of the slices 
to be moved out. 
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Coding Example 
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RV2F751-0 


The second sector in each of the pies is exploded using CHPEXP. 


OPTION BASE 1 


INTEGER LARR 
DIM LARR(3) 


MAT READ LARR 


DATA 0,1,0 


! Move second slice 


CALL GDDM('CHPEXP',3,LARR()) 


ifferences between System/38 and the AS/400 System 


This call is not supported on System/38. 


D 


3-58 AS/400 GDDM Reference 


CHPIE 


CHPIE-Plotting Pie Charts 


CHPIE(data-groups,count,y values) 


Draws one or more pie charts. When more than one pie is drawn, horizontal and 
vertical alignment of the pies is controlled by the CHSET YVERTICAL and 
XVERTICAL options. YVERTICAL specifies pies each beside the other (default) 
and XVERTICAL specifies pies one above the other. 


The positioning and size of pies for a multiple pie chart is based on the number of 
pies specified on the first call to CHPIE, or on the value of CHNUM, if CHNUM was 
used. The CHNUM value takes precedence. 


Unless CHSET(NOFILL) has been specified, each sector of a pie is colored and 
shaded according to the current settings of the attribute tables and the CHSET 
shading option. Corresponding sectors in each pie have the same attributes. 


All axis definition and datum line specifications are ignored, except that any labels 
specified by CHXLAB are used as titles for the pies. 


Valid in state 1 or state 2. If entered in state 1, the program changes to state 2. 


Parameters 
data-groups (4-byte binary integer) 
The number of pie charts to be drawn. 


count (4-byte binary integer) 
The number of sectors in each pie. In a chart with more than one data group, 
all pies must have the same number of sectors. 


y values (array of short floating-point numbers) 
The sizes of the pie sectors in each pie. Must be positive or zero. The data 
can be given in percentages (the default) or in absolute values. Percentage 
values are subject to rounding errors and may not be precise. 
CHSET(PERPIE|ABPIE) can be set to indicate which data type is being used. 


For absolute pie charts, the total for each data group is assumed to correspond 
to 360°, and a complete pie is always drawn. The total for each data group in 
this case must be positive. For percentage pie charts, the total for each data 
group must not exceed 100. If the total is less than 100, an incomplete circle is 
drawn. Sectors are drawn in a clockwise direction, with the first sector 
beginning at the 12 o’clock position. 
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Coding Examples 


RV2F752-0 
The following program displays this pie chart. Two pie charts are drawn with three 
sectors in each pie: 


OPTION BASE 1 


DIM YVALUES (6) ! 6 must be the product of 2 and 3 
MAT READ YVALUES 
DATA 30,40,30, 50,25,25 ! Each 3-sector group adds to 100 


CALL GDDM('CHPIE',2,3, YVALUES()) 
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CHPIER—Pie Reduction 


CHPIER(reduction) 


Reduces the size of each pie in a pie chart. This can be useful if the automatic 
sizing and spacing prevents the display of a multiple pie chart or produces a 
congested chart. 


Valid only in state 1. 


Parameters 

reduction (4-byte binary integer) 
The percentage reduction of the area of each pie constructed. The value must 
be positive: 99 is the largest reduction. 


Coding Examples 
In the following example, the size of pie charts to be drawn is reduced by 90%: 


CALL GDDM('CHPIER', 90) 
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CHPLOT-Line Graphs and Scatter Plots 


CHPLOT(data-groups,count,x values,y values) 


Constructs one or more data groups consisting of line graphs or scatter plots on the 
currently selected axes. By default, markers are drawn at each data point, and 
solid straight lines connect them. The CHSET options (LINES|NOLINES) and 
(MARKERS|NOMARKERS) can be used to suppress the markers, or to produce a 
scatter plot by suppressing the lines. 


CHSET(VALUES) can be specified to show the data value at the end of each data 
point. CHVATT can be specified to control the attributes of the values being 
generated. 


The color of the lines and markers, and the line types, line widths, and markers 
used are determined by the current attribute table settings. The default settings 
can be modified by CHCOL, CHLT, CHLW, and CHMARK. 


Valid in state 1 or state 2. If entered in state 1, the program changes to state 2. 


Parameters 

data-groups (4-byte binary integer) 
The number of data groups to be drawn, that is, the number of individual graph 
lines or groups of scatter plot data. Each data group has a new set of 
attributes. 


count (4-byte binary integer) 
The number of data points in each graph line or scatter plot group. 


X values (array of short floating-point numbers) 
The values of the independent variable (x values). Each data group uses the 
same set of values for the independent variable. For example, if count is 5, 
five values must be supplied. 


y values (array of short floating-point numbers) 
The dependent variable (y values). One value must be supplied for each point 
to be plotted. For multiple data groups, the values must be stored sequentially 
by data group; that is, all values for the first data group, followed by all values 
for the second data group, and so forth, for as many data groups as are 
specified. Each data group must contain as many values as are specified in 
the count parameter. The y values specified for each data group are 
associated in sequence with the x values supplied in the x values parameter to 
give the (x,y) coordinate pairs to be plotted. 
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Coding Examples 
5.00 4 


4.50 7 


4.00 + 


3.50 7 


3.00 + 


2.50 4 


2.00 + 


1.50 7% 


0.00 | 
0 1 2 3 
RV2F753-0 


In the following example, a line graph with three lines of four points each is drawn: 


OPTION BASE 1 

DECIMAL XVALUES, YVALUES 

DIM XVALUES (4) 

MAT READ XVALUES 

DATA 0,1,2,3 

DIM YVALUES (12) ! Number of elements is the product of 3 and 4 
MAT READ YVALUES 

DATA 1,2,2,3.1, 1.2,3,3.2,4, 1.4,3.5,4,5 

CALL GDDM('CHPLOT',3,4,XVALUES() , YVALUES()) 
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CHRNIT-Reinitialize Presentation Graphics Routines 


CHRNIT 


Resets all chart definition options and parameters to their default values. If issued 
in state 2, it also returns the application program to state 1. (See CHSTRT to 
return to state 1 without reinitialization.) 


CHRNIT can be used, for example, to reinitialize the Presentation Graphics routines 
before using CHAREA to construct a second chart in another area of the screen. 
See also CHTERM. 


CHRNIT does not clear charts from the page. Any further charts would be added 
to the existing ones. Charts can be cleared by the GSCLR call, described in 
“GSCLR-Clear the Graphics Field” on page 2-65. 


Valid in state 1 or state 2. If coded in state 2, the application program reenters 
state 1. 


Parameters 
None 


Coding Examples 
The following example shows how to specify CHRNIT: 


CALL GDDM('CHRNIT') 
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CHSET-Specify Chart Options 


CHSET 


CHSET(option) 


Overrides defaults on all chart attributes that are not related to axes. In general, 
any attribute that does not need a value and does not refer to an axis is an option 


of CHSET. 


Only one option may be set by each CHSET call. For example, to request a 


left-justified heading in the bottom margin, two calls are needed: 


CHSET ('HBOT') 
CHSET ('HLEFT') 


Unless otherwise stated, CHSET calls are valid only in state 1. 


Parameters 
option (4-byte character string) 


The option string must be at least four characters long, and must be enclosed 
in single quotes. If more than four characters are specified, they are ignored. 
However, they may be used to increase the readability of the program. 


The options are as follows, in alphabetic order by function; the defaults are 


shown in uppercase BOLD. 


Function 
Axis, autoranging 
Axis, time of drawing 


Bar chart, type 


Bar values, placement 


Chart area, boxed or shaded 


Curve fitting or not 
Data, absolute or relative 


Date label abbreviations 


Heading justification 


Heading or not 


Option 
YVERTICAL 
XVERTICAL 


IDRAW 
DRAW 
NDRAW 


MBAR 
CBAR 
FBAR 


VINSIDE 
VONTOP 


CBOX 
CBACK 
NCBOX 


CURVE 
NOCURVE 


RELATIVE 
ABSOLUTE 


ABREV 
FULL 
LETTER 


HCENTER 
HLEFT 
HRIGHT 


HEADING 
NOHEADING 
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Function 
Heading position 


Histogram risers 


Label areas blanked 


Legend areas blanked 


Legend, box around 


Legend or not 


Legend, order of elements 


Line graphs, lines 


Line graphs, markers 


Marker scaling 


Notes, box around 


Number punctuation 


Pie charts, labeling appearance 


Pie charts, labeling type 


Pie charts, relative size 


Pie data, type of 


Shading, mountain range 


Shading type 


Value labels 


Value labels, blanking behind 


xX axis, secondary specification 


y axis, secondary specification 
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Option 
HTOP 
HBOTTOM 


RISERS 
NORISERS 


BLABEL 
NBLABEL 


NBKEY 
BKEY 


KBOX 
NKBOX 


LEGEND 
NOLEGEND 


KNORMAL 
KREVERSED 


LINES 
NOLINES 


MARKERS 
NOMARKERS 


BNOTE 
NBNOTE 


NBOX 
NONBOX 


PGFS 
NPGFS 


SPISLICE 
SPILABEL 


PIEKEY 
SPIDER 


PROPIE 
NOPROPIE 


PERPIE 
ABPIE 


MOUNTAIN 
NOMOUNTAIN 


FILL 
INFILL 
NOFILL 


CVALUES 
VALUES 
NOVALUES 


BVALUES 
NBVALUES 


XDUP 
XNOD 


YDUP 
YNOD 


CHSET Options 


CHSET 


The groups of CHSET options are listed in alphabetic order by option. 
¢ CHSET 'ABREV' | 'FULL' | 'LETTER' 


Specifies the form of axis labels supplied by CHXMTH, CHYMTH, CHXDAY, 
and CHYDAY. It applies to all charts except pie charts and Venn diagrams. 


ABREV specifies three-character abbreviations. 


FULL specifies complete words. 


LETTER specifies first letters only. 


The following tables list the month/day sequence numbers and variations. 
Number ABREV 


Month 


ONAN WNY Fe 


JAN 
FEB 
MAR 
APR 
MAY 
JUN 
JUL 
AUG 
SEP 
OCT 
NOV 
DEC 


MON 
TUE 
WED 
THU 
FRI 
SAT 
SUN 


FULL LETTER 


JANUARY 
FEBRUARY 
MARCH 
APRIL 
MAY 

JUNE 
JULY 
AUGUST 
SEPTEMBER 
OCTOBER 
NOVEMBER 
DECEMBER 


oOozaounrwwezereZzanau 


MONDAY 
TUESDAY 
WEDNESDAY 
THURSDAY 
FRIDAY 
SATURDAY 
SUNDAY 


nAnnnaAeadnts 


¢ CHSET 'ABSOLUTE' | 'RELATIVE' 
ABSOLUTE specifies that absolute data values are supplied. 


RELATIVE specifies that the dependent data values, for all data groups except 
the first, are relative to the previous component. Relative data is the natural 


and recommended form of data for all chart types that involve stacking of 


components. The depth of each bar (or layer in a surface chart) then gives the 
absolute data value. The following example illustrates this point: 


Component 


1 
2 
3 


Value Supplied 


2 
5 
3 


Value Plotted 
2 


7 
10 
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The resultant bar chart is: 


KKKKKK 
KKKKKK 


¢ CHSET 'BKEY' | 'NBKEY' 


BKEY specifies that the rectangular area to be occupied by the legend is 
blanked before the legend is constructed. 


NBKEY specifies that the legend area is not blanked. 
¢ CHSET 'BLABEL' | 'NBLABEL' 


Controls blanking of the areas to be occupied by axis labels, before the labels 
are constructed. It can be used with CHSET('CBACKk'), CHSET('DRAW’), or 
CHDRAX, to ensure that the axis labels are not obscured by background 
shading or some aspect of the plot. 


Valid in state 1 or state 2. 

NBLABEL does not blank label areas. 

BLABEL blanks the label areas before the labels are written. 
¢ CHSET 'BNOTE' | 'NBNOTE' 


Controls the blanking of areas to be occupied by notes, before the notes are 
written (See CHNOTE). 


BNOTE blanks note areas before the notes are written. 
NBNOTE does not blank note areas. 
Valid in state 1 or state 2. 

¢ CHSET 'BVALUES' | 'NBVALUES' 


Controls blanking of the areas to be occupied by data values on bar, line, or 
surface charts if CHSET('VALUES)) is set. 


Valid in state 1 or state 2. 

NBVALUES does not blank the value areas. 

BVALUES blanks the value areas before the values are written. 
¢ CHSET 'CBOX' | 'NCBOX' | 'CBACK' 


Permits the drawing of a framing box about the perimeter of the chart area or 
the shading of the background. Defaults for the attributes of the lines defining 
the box can be overridden by CHBATT. 


CBOX specifies that the box is to be drawn. 
NCBOX suppresses the framing box. 
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CBACK specifies that the entire chart area is to be shaded with a solid pattern 
as a background, in addition to drawing the framing box. The background color 
will be the same as the lines defining the box, as set by CHBATT. 


CBACK should not be used for Venn diagrams, for monochrome devices, or 
when the chart is to be printed. Furthermore, remember that the data streams 
generated by this option may be very long, because many more cell definitions 
are generated with multicolor contents. PS stores may be quickly exhausted 
with other than simple charts. Note that to cancel a CBACK request, CBOX or 
NCBOX must be specified. 


CHSET 'CURVE' | 'NOCURVE' 


Controls the manner in which the supplied data points in a line graph, surface 
chart, or polar chart are connected. Each consecutive pair of points may be 
connected by a straight line, or by a smooth curve. For a line graph or polar 
chart, it is effective only if CHSET(‘'LINES’) is also specified (or defaulted). 


If a smooth curve is specified, the smoothness of the curve may be controlled 
by the CHFINE call. Note that the smooth curve constructed by use of this 
option is not intended to provide an interpretation of the supplied data values. 
Rather, the option is provided purely for its cosmetic effect on the resulting 
graph. 

Valid in state 1 or state 2. 


CURVE specifies that consecutive data points within each data group of a line 
graph, polar chart, or surface chart are to be connected by a smooth curve 
constructed using the current data-group attributes. 


NOCURVE specifies that consecutive data points within each data group of a 
line graph, polar chart, or surface chart are to be connected by straight lines 
constructed using the current data-group attributes. 


CHSET 'CVALUES' | 'VALUES' | 'NOVALUES' 


Specifies how values are to be displayed for bar charts (or, in the case of the 
'VALUES' option, for bar, pie, line, and surface charts). 


Valid in state 1 or state 2. 


CVALUES specifies that controlled bar-chart values are to be provided. 

Related calls are CHSET('VINSIDE' | 'VONTOP') and CHVATT with the 
bar-value rotation option. Values and bars might overlap on composite 
(stacked) or floating bar charts. See “CHVCHR—Number of Characters in Value 
Labels” on page 3-86 for a further discussion. Text attributes for the value 
representations are set by CHVATT. The area to be occupied by each bar 
value may be blanked, before the value is constructed, with the BVALUES 
option. 


VALUES controls the appearance of dependent data values at the ends of bars 
on bar charts, at the data points of line and surface charts, or the percentage 
values on pie charts. 


For bar charts, VALUES constructs character representations of the dependent 
data values at the end of each bar, on each CHBAR or CHBARX call. Overlap 
of values and bars may occur on composite (stacked) or floating bar charts. 
See the description of CHVCHR for further discussion. Text attributes for the 
value representations are set by CHVATT. The area to be occupied by each 
bar value may be blanked, before the value is constructed, with the BVALUES 
option. 


Chapter 3. Presentation Graphics Routines 3-69 


CHSET 


For line and surface charts, VALUES constructs character representations of 
the dependent data values above or below each data point on each CHPLOT 
or CHSURF call. Overlap of values may occur. See “CHVCHR—Number of 
Characters in Value Labels” on page 3-86 for further discussion. Text 
attributes for the value representations are set by CHVATT. The area to be 
occupied by each value may be blanked before the value is constructed, with 
the BVALUES option. 


Following are the rules for the number of decimal places that are generated on 
bar, line, and surface chart values when displaying the chart: 
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All values always have the same number of decimal places displayed, even 
if they did not have the same number when entered. 


If at least one value entered has at least one decimal place, a minimum of 
two decimal places is displayed for all values. For example, if the values 
12, 18, and 15.1 were input, the displayed values would have two decimal 
places (12.00, 18.00, and 15.10). 


If at least one of the bar values entered has more than five digits to the left 
of the decimal point, then a digit will be eliminated to the right of the 
decimal point to accommodate each extra digit. 


If all values entered are equal, two decimal places are always displayed. If 
more than two decimal places were entered, the value is rounded off to two 
decimal places. For example, if the values 38.748, 38.748, and 38.748 
were input, the displayed values would be 38.75, 38.75, and 38.75. 


The following table describes the general algorithm used to determine the 
number of decimal places generated: 


Decimal Places 
Smallest Difference Between Values Displayed 
1 > diff>=.1 2 
.1 > diff>= .01 3 
.01 > diff >= .001 4 
.001 > diff >= .0001 5 
.0001 > diff >= .00001 6 
.00001 > diff >= .000001 7 


Note: diff can either be between two input values or between an input 
value and its truncated integer value. For example, if the values 
34.004, 33.054, and 32.844 were specified as input, six differences 
would be considered: 


1. 34.004 - 33.054 = 0.950 (Difference between value 1 and 


value 2) 

2. 34.044 - 32.844 = 1.160 (Difference between value 1 and 
value 3) 

3. 33.054 — 32.844 = 0.210 (Difference between value 2 and 
value 3) 


4. 34.004 - 34.0 = 0.004 (Difference between value 1 and 
truncated value 1) 

5. 33.054 - 33.0 = 0.054 (Difference between value 2 and 
truncated value 2) 


CHSET 


6. 32.844 - 32.0 = 0.844 (Difference between value 3 and 
truncated value 3) 


The smallest difference (which is used to determine the number of 
decimal places displayed) would be 0.004, which is the difference 
between 34.004 and 34, where 34 is the truncated value of 34.004. 
This would produce the following values with four decimal places: 
34.0040, 33.0540, and 32.8440. 


For pie charts, VALUES has two possible meanings: 


— If the option CHSET('PIEKEY') (the default) is in effect, integer percentage 
data values are constructed as spider labels around the pie, connected to 
their corresponding slices by lines. Each consists of the character 
representation of the integer closest to the percentage slice value, followed 
by a % sign. 

— If CHSET('SPIDER)’) is in effect, spider labels are constructed, each 


consisting of a percentage representation as above, followed by a label text 
string as specified by CHKEY. 


In both cases, the data values are always in percentage form, regardless of 
the pie chart data type. See CHSET('SPISLICE’) for a description of text 
attributes. 


NOVALUES indicates that no values are given on bar charts, pie charts, line 
charts, or surface charts. 


CHSET 'FILL' | 'INFILL' | 'NOFILL’ 


Specifies the method of shading. Applies to all charts except line graphs and 
scatter plots. Note that shading, when specified, always shades the interior of 
a defined boundary. If the defined boundary crosses itself, the effects of 
shading may be unexpected. 


Valid in state 1 or state 2. 


Shading patterns are taken from the pattern-attribute table. The default table 
may be overridden by a call to CHPAT. 


— Surface charts, bar charts, and histograms 


FILL specifies that all data groups are shaded with patterns taken from the 
pattern-attribute table. The first data group specified in a plotting routine 
call is shaded to the x axis (or y datum reference line if specified). 
Subsequent data groups in the same call are shaded to the previous data 
group. 

INFILL is equivalent to FILL for multiple bar charts. It suppresses the 
shading of the first data group for surface charts, histograms, and 
composite (stacked) bar charts. 


NOFILL suppresses all shading for all charts except surface charts, for 
which it is equivalent to INFILL. 


— Pie charts 


FILL specifies that all pie slices are shaded with patterns taken from the 
pattern-attribute table. Corresponding slices in different pies are shaded 
with the same pattern. 


INFILL is equivalent to FILL. 


NOFILL suppresses shading for all pie slices. 
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— Venn diagrams 


FILL specifies that the two population circles are shaded with patterns from 
the pattern attribute table. 


INFILL is equivalent to FILL. 
NOFILL suppresses shading of the two population circles. 


¢ CHSET 'HCENTER' | 'HLEFT' | "HRIGHT' 


Controls the justification of the chart heading. 


HCENTER specifies that each line of the heading is centered between the left 
and right edges of the chart area. 


HLEFT specifies that each line of the heading is left-justified to the edge of the 
chart area. 


HRIGHT specifies that each line of the heading is right-justified to the edge of 
the chart area. 


CHSET 'HEADING' | 'NOHEADING' 

This option controls whether or not the chart heading is displayed. 
HEADING specifies that the heading is displayed. 

NOHEADING specifies that the heading is suppressed. 

CHSET 'HTOP' | 'HBOTTOM' 

Controls the location of the chart heading. 

HTOP specifies that the heading is placed in the top margin. 
HBOTTOM specifies that the heading is placed in the bottom margin. 
CHSET 'IDRAW' | 'DRAW' | 'NDRAW' 


This option governs the time of construction of the axes, together with their 
scale marks, labels, and associated grid/datum lines. 


Valid in state 1 or state 2. 


IDRAW specifies that each axis is constructed automatically at the time of its 
definition, that is, when the first plotting routine call is issued with the axis 
selected. In this case each axis is constructed once and once only, before the 
data supplied on the plotting routine call is plotted. Data thus overwrites the 
axis where they cross. 


DRAW specifies that each axis is constructed automatically on each plotting 
routine call for which the axis is selected, after the data is plotted. In this case 
each axis is constructed as many times as there are plotting routine calls for 
which the axis is selected. The axis thus overwrites the data. DRAW may 
result in unnecessary processing if several plotting routines calls are made. In 
such a situation, data can be overwritten using the CHDRAX call and possibly 
the NDRAW option. 


NDRAW suppresses the automatic construction of axes on plotting routine 
calls. Axis drawing can be explicitly requested by means of a CHDRAX call. 


In all cases, axis construction may be forced at any time in state 2 by execution 
of CHDRAX. 


¢ CHSET 'KBOX' | 'NKBOX' 


3-72 AS/400 GDDM Reference 


CHSET 


Controls the construction of a box around each key in the legend. NKBOX 
specifies that no key box is to be constructed. 


KBOX specifies that each key in the legend is surrounded by a box whose 
attributes are the same as those for the primary x axis line (see CHAATT). 


¢ CHSET 'KNORMAL' | 'KREVERSED 
Controls the order of items in a legend (K stands for Key). 
KNORMAL specifies that the first key is on the left or bottom. 


In a horizontal legend, each row of key entries is constructed from left to right 
(using the keys in the order in which they are defined by a CHKEY call). 
Similarly, in a vertical legend, each column of key entries is constructed from 
bottom to top. 


KREVERSED specifies that the first key is on the right or top. 


In a horizontal legend, each row of key entries is constructed from right to left 
(using the keys in the order in which they are defined by a CHKEY call). 
Similarly, in a vertical legend, each column of key entries is constructed from 
top to bottom. 


¢ CHSET 'LEGEND' | 'NOLEGEND' 


Specifies whether a legend is to be constructed. Legends are not produced for 
Venn diagrams irrespective of the setting of this option. See the PIEKEY 
option for information about construction of legends for pie charts. 


LEGEND specifies that a legend is to be constructed after any subsequent 
plotting calls (for example, CHPLOT, CHBAR, and CHBARX). 


Valid in state 1 or state 2. 
NOLEGEND specifies that a legend is not to be constructed. 
Valid in state 1 only. 

¢ CHSET 'LINES' | 'NOLINES' 


Controls whether CHPLOT and CHPOLR produce a line graph (LINES) or a 
scatter plot (NOLINES). 


Valid in state 1 or state 2. 


LINES specifies that consecutive points on each data group are joined by a 
line, or curve (see CHSET('CURVE’)). 


NOLINES specifies that only the markers are drawn, giving the effect of a 
scatter plot. If the CHSET('NOMARKERS)) option is specified, nothing is drawn 
for CHPLOT. 


¢ CHSET 'MARKERS' | 'NOMARKERS' 
Indicates whether markers are shown. 
Valid in state 1 or state 2. 


MARKERS specifies that markers on line graphs, scatter plots, or polar charts 
appear at the data points specified on a CHPLOT or CHPOLR call. Markers 
are obtained from the marker-attribute table. The default marker table can be 
overridden by a CHMARK call. 


NOMARKERS suppresses the construction of markers. 
¢ CHSET 'MBAR' | 'CBAR' | 'FBAR' 
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Specifies the type of bar chart to be constructed. 

Valid in state 1 or state 2. 

MBAR specifies a multiple bar chart (groups of bars, side-by-side). 

CBAR specifies a composite (stacked) bar chart (colinear bars). 

FBAR specifies a floating bar chart (like a stacked bar chart but with first data 
group bars omitted). 

CHSET 'MOUNTAIN' | 'NOMOUNTAIN' 


MOUNTAIN specifies that for surface charts the successive data groups appear 
behind the previous data groups so that the shading does not overlap. This 
effect is called mountain-range shading. Chart details (for example, grid lines 
and data lines) that are behind a mountain range are not shown. The first 
component is shaded if the CHSET option 'FILL' has been specified; otherwise, 
shading is suppressed. Also, this option is not valid for hardcopy devices 
(plotters and printers). 


NOMOUNTAIN suppresses mountain-range shading and restores the standard 
method of shading. 


CHSET 'NONBOX' | 'NBOX'’ 


Controls the construction of a framing box round all subsequent chart notes, 
until the option is changed. Refer to the CHNOTE call description for the 
parameters that affect framing-box construction. 


Valid in state 1 or state 2. 


NONBOX suppresses construction of a framing box round subsequent chart 
notes. 


NBOX specifies construction of a framing box round subsequent chart notes. 
CHSET 'PERPIE' | ‘ABPIE' 

Specifies the data type for pie charts. 

Valid in state 1 or state 2. 


PERPIE specifies that the data supplied in any subsequent calls to CHPIE is a 
percentage. Each slice subtends an angle of V*360/100 degrees, where V is 
the data value for the slice. 


If the total for all slices is less than 100, the complete circle is not drawn. If it is 
greater than 100, an error message is issued. 


ABPIE specifies that the data is absolute. All values of a pie are added 
together and the slice angle determined as a proportion of the total. Each slice 
subtends an angle of V*360/T degrees, where V is the data value and T is the 
total of all data values for the pie. 


CHSET 'PGFS' | 'NPGFS' 


Specifies the method used to punctuate numbers of 1000 and over. The 
convention is used for the display of numeric data values in fixed-point format. 
Applies to all numeric axis labels, to bar values on bar charts, and to table 
chart values. These options are used in CHXSET and CHYSET calls to specify 
punctuation for numeric labels on the x or y axis. 


Valid in state 1 or state 2. 
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PGFS suppresses all punctuation except the decimal point. This minimizes the 
space required for numeric values, for example: 


1234567 .999 


NPGFS selects the default national convention that may be specified when 
GDDM is installed. Widely used conventions are: 


— The period decimal convention. Example: 1,234,567.999 

— The comma decimal convention. Example: 1.234.567,999 

— The French convention. Example: 1 234 567,999 

CHSET 'PIEKEY' | ‘SPIDER’ 

Specifies the configuration of pie chart labels. 

PIEKEY specifies that a legend will be constructed in the chart margin. 


SPIDER suppresses the generation of a legend, and specifies the construction 
of spider labels consisting of the labels specified by CHKEY written around the 
circumference of each pie. The labels are connected to their corresponding 
slices by lines. See CHSET('SPISLICE’) for further discussion. 


Note: Any labels supplied by CHXLAB are written as pie titles adjacent to the 
pies, independently of labels supplied by CHKEY. 


CHSET 'PROPIE' | '"NOPROPIE' 


Applies only to multiple pie charts using absolute (not percentage) data, 
generated by a single call to CHPIE. 


NOPROPIE specifies that all pies generated are the same size. 


PROPIE specifies that the area of each pie will be proportional to the sum of its 
slice values. The pies generated from a single call to CHPIE will be in 
proportion. The largest pie in each such group of pies has the same size as if 
NOPROPIE had been specified, and the remaining pies are reduced in 
proportion. 


CHSET 'RISERS' | 'NORISERS' 
Controls whether steps of a histogram are delimited by riser lines. 
Valid in state 1 or state 2. 


RISERS specifies that lines perpendicular to the x axis are drawn at the ends 
of each histogram range. NORISERS suppresses the generation of 
intermediate histogram risers. The two outermost risers remain, joining the 
ends of the step to the x axis or datum reference line. 


CHSET 'SPISLICE' | ‘SPILABEL' 


Specifies the appearance of pie-chart labels. It determines whether the pie 
labels and spider lines are the same colors as the slice to which they are 
attached, or are controlled by CHKATT or CHVATT. SPISLICE and SPILABEL 
are effective only if slice values, or slice labels, or both are specified. Slice 
values are specified by CHSET('VALUES’), and slice labels are specified by 
CHKEY and CHSET('SPIDER’). 


Valid in state 1 or state 2. 


SPISLICE draws the spider line and associated text (slice value, or label, or 
both) in the color of the corresponding slice. The character mode, symbol-set 
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identifier, and character multiplier for the text are determined by CHKATT if 
CHSET(‘'SPIDER)) is in effect, by CHVATT otherwise. 


SPILABEL draws the spider lines in the default color. The associated text 
attributes are those specified by CHKATT if CHSET('SPIDER’) is in effect, by 
CHVATT otherwise. 


CHSET 'VINSIDE' | 'VONTOP' 


Controls the placement of values for bar charts. The values can appear either 
on top of or inside the bars. A CHSET('CVALUES)) call is required if you 
specify one of these options. 


VINSIDE specifies that bar values are to be centered within each bar. 
VONTOP specifies that bar values are to be placed on top of the bars. 
Valid in state 1 or state 2. 

CHSET 'XDUP' | 'XNODUP' 

CHSET 'YDUP' | 'YNODUP' 

These options specify that a duplicate of the primary axis is used as a 
secondary axis. By default this will give axes at both sides or ends of the 
graph. 

XDUP specifies that the primary x axis is duplicated. 

YDUP specifies that the primary y axis is duplicated. 

XNODUP specifies that the x axis is not duplicated. 

YNODUP specifies that the y axis is not duplicated. 

For pie charts and Venn diagrams, a duplicate axis specification is ignored. 


When a duplicate axis is specified, the secondary axis is used to support it. 
For this reason, certain items are copied into the secondary axis fields on entry 
to state 2 if the duplicate axis option is set. The following items are copied: 
axis range, scale mark positions, scale type (linear or logarithmic), scaling 
factor, and axis attributes (line type, width, and color). These supersede any 
corresponding items that may have been explicitly specified for the secondary 
axis. Also, the secondary axis grid lines option is suppressed to avoid 
redrawing grid lines. 


CHSET 'YVERTICAL' | 'XVERTICAL’ 


Specifies the orientation of a// axes; also controls the orientation of multiple pie 
charts, and Venn diagrams. 


YVERTICAL specifies that the y axis should be vertical and the x axis 
horizontal. YVERTICAL is the default and creates horizontal line graphs, and 
bar charts and histograms with vertical bars. Venn diagrams are arranged 
horizontally and pie charts in a horizontal line if there are more than one. 


XVERTICAL specifies that the x axis is to be vertical and the y axis horizontal. 
XVERTICAL creates vertical line graphs, and bar charts and histograms with 
horizontal bars. Venn diagrams are vertically aligned. Pie charts are arranged 
above one another if there are more than one. 
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Differences between System/38 and the AS/400 System 
The following options are not supported on System/38: 


* CHSET (CVALUES|VALUES|NOVALUES) 
* CHSET (VINSIDE|VONTOP) 
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CHSTRT-Reset the Processing State to State 1 


CHSTRT 


If issued in state 1, CHSTRT has the same effect as CHRNIT. It resets all chart 
definition options and parameters to their default values. 


If issued in state 2 (as is usually the case), CHSTRT resets the processing state to 
state 1, and resets the chart definition options and parameters to their values just 
before the most recent transition from state 1 to state 2. CHSTRT also causes the 
primary axes to become selected. Note that because very few options can be set 
in state 2, CHSTRT leaves most settings unaltered. 


CHSTRT can be used to plot a series of charts using the same (or similar) formats, 
without the overhead of specifying again the common format for each chart. 


Parameters 
None 


Coding Example 


The following example shows how to use CHSTRT: 
CALL GDDM('CHSTRT') 
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CHSURF-—Surface Charts 


CHSURF (data-groups,count,x values,y values) 


This call produces one surface chart on the currently selected axes. 


A surface chart is essentially a shaded line graph without marker symbols. As ina 
line graph, each data group is drawn as a series of lines connecting the data 
points. 


CHSET(VALUES) can be specified to show the data value at the end of each data 
point. CHVATT can be specified to control the attributes of the values being 
generated. 


Data group colors, shading patterns, line types, and line widths are determined by 
the current attribute tables. The default settings can be modified by CHCOL, 
CHPAT, CHLT, and CHLW. Surface charts are, in general, drawn with relative 
data and are often improved by curved lines. CHSET(RELATIVE) and 
CHSET(CURVE) control these aspects. 


Type of shading can be controlled by the CHSET(MOUNTAIN|NOMOUNTAIN) call. 
Shading of the first data group can be suppressed by calling CHSET(INFILL). 


Valid in state 1 or state 2. If coded in state 1, the program changes to state 2. 


Parameters 

data-groups (4-byte binary integer) 
The number of data groups to be drawn, that is, the number of individual graph 
lines. Each data group has a new set of attributes. 


count (4-byte binary integer) 
The number of data points in each data group. 


x values (array of short floating-point numbers) 
The x values for the chart. Each data group uses the same set of x values. 
For example, if count is 5, five values must be supplied. 


y values (array of short floating-point numbers) 
The y values for the chart. One value must be supplied for each point to be 
plotted. For multiple data groups, the values must be stored sequentially by 
data group; that is, all values for the first data group, all values for the second 
data group, and so forth, for as many data groups as specified. Each data 
group must contain count values. The y values specified for each data group 
are associated in sequence with the x values supplied in the x values 
parameter to give the (x,y) coordinate pairs to be plotted. 
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Coding Example 
124 


0 1 2 3 
RV2F755-0 


The following shows how to draw this surface chart (with three lines of four points 


each): 
OPTION BASE 1 
CALL GDDM('CHSET', 'RELATIVE') ! Draw with relative data 
CALL GDDM('CHSET','CURVE') ! Use curved lines 


DECIMAL XVALUES, YVALUES 

DIM XVALUES (4) 

MAT READ XVALUES 

DATA 0,1,2,3 

DIM YVALUES (12) 

MAT READ YVALUES 

DATA 1,2,3.1,0.5, 1.2,3,3.2,1.4, 1.4,3.5,5,3.3 
CALL GDDM('CHSURF',3,4,XVALUES() , YVALUES ()) 
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CHTATT-Axis Title Text Attributes 


CHTATT(count,array) 


Overrides or resets the default attributes to be used for all axis titles. 


The defaults are: 


Color 0 (green on displays, black on printers, highest 
pen number on plotters) 

Character mode 3 

Symbol-set identifier 0 (default characters for the device) 

Character size multiplier 100 results in the character size of device 


unless overridden by CHCGRD 


Valid only in state 1. 


Parameters 

count (4-byte binary integer) 
The number of elements in the array parameter. If more than four elements 
are specified, the excess elements are ignored. If fewer than four are 
specified, the remainder are unchanged from their previous setting. If count is 
zero, all four defaults are reinstated. 


array (array of 4-byte binary integers) 
The elements of the array are the following attributes: 


1. Color (valid values have the same effect as the GDDM routine GSCOL). 


For valid values of color, see Appendix C, “Colors, Line-Types, Markers, 
and Shading Patterns.” 


2. Character mode. 
Valid values are: 


0 System default (mode 3) 
2 Mode 2 
3 Mode 3 


3. Symbol-set identifier. 
For mode 2 or mode 3, the identifier denotes: 


0 Default character set 

8 Double-byte character set data (no shift-out or shift-in) 

n A graphics symbol set that has been previously loaded using the 
GDDM call GSLSS 
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4. Character size multiplier. 


For mode 2 or mode 3, the character size multiplier is divided by 100, and 
the horizontal and vertical spacings or sizes specified by CHCGRD (or its 
defaults) are multiplied by this factor before the characters are drawn. (The 
default character size is the size of hardware characters for the device on 
which the chart is displayed.) For example, if character size multiplier is 
200 and mode-3 characters are being used, they are drawn twice as large 
as the basic. The character size multiplier must have a value greater than 
zero. 


Coding Example 


The following example shows how to use CHTATT: 


OPTION BASE 1 

INTEGER ARRAY 

DIM ARRAY (4) 

MAT READ ARRAY 

DATA 7,3,65,150 

CALL GDDM('CHTATT',4, ARRAY ()) 


Differences between the System/370 Computer and the AS/400 


System 
On the AS/400 system, character mode 1 is not supported. 
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CHTERM-Terminate Presentation Graphics Routines 


CHTERM 


Terminates the Presentation Graphics routines. The main action taken is to free 
any storage obtained on previous calls to the Presentation Graphics routines. Use 
CHTERM when your application program has finished using the Presentation 
Graphics routines. 


Further, it is recommended that CHTERM be issued as soon as the final form of 
the chart has been constructed, and before ASREAD or FSFRCE is called to send 
data to the device. This practice provides the most efficient use of storage. The 
next call to the Presentation Graphics routines (after return from ASREAD or 
FSFRCE) is treated as if it were the first call. CHTERM thus provides the same 
function as CHRNIT, except that it also releases all storage used by the 
Presentation Graphics routines. 


Neither CHTERM nor CHRNIT clears charts from the page. Any further charts 
would be added to the existing ones. Charts can be cleared by the GSCLR call. 


Valid in state 1 or state 2. 


Parameters 
None 


Coding Example 


The following example shows how to use CHTERM: 
CALL GDDM('CHTERM') 


Chapter 3. Presentation Graphics Routines 3-83 


CHVATT 


CHVATT-Attributes of Values Text in Bar and Pie Charts 


CHVATT(count,array) 


Overrides or resets the default attributes to be used for data values on bar, line, 
and surface charts, or for percentage values on pie charts. These values are only 
shown if CHSET(VALUES) has been specified. 


See CHSET(SPISECTOR) for a description of the applicability of CHVATT to pie 
chart spider labels. 


By default, the attributes are as follows: 


Color 0 (green on displays, black on printers, highest 
pen number on plotters) 

Character mode 3 

Symbol-set identifier 0 (default characters for the device) 

Character size multiplier 100 results in the character size of device 


unless overridden by CHCGRD 


Character height/width multiplier 100 results in the character size of device 
unless overridden by CHCGRD 


Rotation 0 


Valid in state 1 only. 


Parameters 

count (4-byte binary integer) 
The number of elements in the array parameter. When more than six elements 
are specified, the excess elements are ignored. When fewer than six are 
specified, the remainder are unchanged from their previous setting. If count is 
zero, all six defaults are reinstated. 


array (array of 4-byte binary integers) 
The elements of the array are the following attributes: 


1. For valid values of color, see Appendix C, “Colors, Line-Types, Markers, 
and Shading Patterns.” 


2. Character mode. 
Valid values are: 


0 System default (mode 3) 
2 Mode 2 
3 Mode 3 


3. Symbol-set identifier. 
For mode 2 or mode 3, the identifier denotes: 


0 Default character set 
n A graphics symbol set that has been previously loaded using the 
GDDM call GSLSS 
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4. Character size multiplier. 


For mode 2 or mode 3, the character size multiplier is divided by 100, and 
the horizontal and vertical character sizes are multiplied by this factor 
before the characters are drawn. The default character size is the size of 
the hardware character for the device. For example, if character size 
multiplier is 200 and mode 3 characters are being used, they are drawn 
twice as large as normal. The character size multiplier must have a value 
greater than zero. 


5. Character height/width multiplier. 


Specifies the height of the character box relative to its width. For example, 
100 indicates that the height is multiplied by the same amount as the width; 
200 causes the height to be multiplied by twice the amount of the width. 


6. Rotation. 


Value labels may be rotated away from the horizontal. This element must 
have a value from —9000 through +9000. This number is divided by 100 to 
give a value from —90 through +90 (the angle in degrees) to the horizontal 
at which value labels are drawn. The default is zero. When positive, the 
angle is in a counterclockwise direction. When negative, it is in a clockwise 
direction. 


Coding Example 


The following example shows how to use CHVATT: 


OPTION BASE 1 

INTEGER ARRAY 

DIM ARRAY (4) 

MAT READ ARRAY 

DATA 7,3,65,150 

CALL GDDM('CHVATT',4, ARRAY ()) 


Differences between the System/370 Computer and the AS/400 


System 
On the AS/400 system, character mode 1 is not supported. 


Chapter 3. Presentation Graphics Routines 3-85 


CHVCHR 


CHVCHR-—Number of Characters in Value Labels 


CHVCHR(number) 


Overrides the default maximum number of characters to be used for displaying the 
value on each bar of a bar chart, or on each data point of a line or surface chart if 
CHSET(VALUES) is specified. Value text attributes are controlled by CHVATT. 


The default maximum is 9. 


Valid in either state 1 or state 2. 


Parameters 

number (4-byte binary integer) 
The maximum number of value characters that are displayed at the end of 
each bar of a bar chart, or at each data point of a line or surface chart. This 
includes the minus sign, decimal point character, and separator characters for 
10**3 and 10**6 positions, if present. If a value cannot be displayed in this 
number of characters, asterisks replace it. 


The default value is 9, and the maximum is 15. Since the 15-character 
maximum includes the sign, decimal point, and possibly a signed exponent, the 
maximum number of digits displayed is eight. 


For bar charts, if the number of characters specified does not fit across the bar, 
and character-mode 3 is specified for the value text, the character box width or 
height is adjusted to force a fit. Note that this can produce very small mode-3 
characters. 


For line and surface charts, no character size adjustments are made. This is 
the responsibility of the programmer. 


In general, the Presentation Graphics routines involved use the minimum 
number of characters needed to distinguish between different values. The 
format used is similar to those of the matching y axis labels. 


Coding Example 


The following example shows how to use CHVCHR: 


CALL GDDM('CHSET', 'VALUES') 
CALL GDDM('CHVCHR',2) 
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CHVENN-Venn Diagram 


CHVENN(population1 ,population2,overlap) 


Draws a Venn diagram. 


Two circles are drawn within the plotting area, proportional in area to the first two 
population data values supplied, and positioned in such a way that the area of their 
overlap is proportional to the third overlap parameter supplied. 


The centers of the circles can be aligned horizontally or vertically with the first circle 
to the left or at the top respectively. Alignment specifications are controlled by the 
CHSET option YVERTICAL (default horizontal alignment) or XVERTICAL (vertical 
alignment). 


Three labels corresponding to the three populations can be specified by CHKEY; 
their attributes are controlled by CHKATT. The labels are constructed in the chart 
margins. If fewer than three labels are specified, only those specified appear. If 
more than three are specified, only the first three are used. 


When the circles are arranged horizontally, the label for the first area is to the left, 
the label for the second area is to the right, and the label for the area of overlap is 
below the overlapping area. The labels are joined to the areas by straight lines. If 
no overlap exists, the third label does not appear. 


When the circles are arranged vertically, the first label is above, the second label is 
below, and the third label is to the left of the circles. 


Each circle is shaded and colored according to the current settings of the attribute 
tables and the CHSET shading option setting. The intersection merges the two 
shading patterns and mixes the two color settings. Because color mixing is used 
for Venn diagrams (and only Venn diagrams), CHSET(CBACK) should not be 
specified for a Venn diagram. Color and shading attribute tables can be altered by 
CHCOL and CHPAT. 


Only one Venn diagram can be produced at a time. Subsequent invocations of this 
call in state 2 produce an error message. 


Valid only in state 1. 


Parameters 

population1 (short floating-point number) 
The size of the set represented by the area of the first circle. Must not be 
negative. 


population2 (short floating-point number) 
The size of the set represented by the area of the second circle. Must not be 
negative. 


overlap (short floating-point number) 
The size of the intersection of the two population sets, represented by the area 
of overlap of the two circles. Must be less than or equal to the smaller of 
population! or population2. Must not be negative. 
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Coding Example 


RV2F756-0 
The following shows how to draw this Venn diagram: 


CALL GDDM('CHVENN', 1000.0, 2100.0, 400.0) 
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CHVMAR-Left and Right Margins 


CHVMAR (left-margin, right-margin) 


Overrides the default left and right chart margins, and hence the size of the plotting 
area also. The margin control sizes are specified in terms of character grid rows 
and character grid columns, where the character grid is defined by CHCGRD, or is 
taken by default (the default is the hardware character size of the device on which 
the chart is displayed or printed). By default, the horizontal margins are 5 
character-rows above and below the plotting area, and the vertical margins are 10 
character-columns on each side of the plotting area. 


For top and bottom margins, use CHHMAR. 


CHHMAR and CHVMAR can be used to enlarge the margins to give more room for 
the legend, or to reduce them to give more room to the chart. 


Valid only in state 1. 


Parameters 

left-margin,right-margin (4-byte binary integers) 
The number of character columns at the left and right sides respectively of the 
plotting area. 


Coding Example 
In the following example, CHVMAR sets the left margin and right margins so that 
the plotting area is 15 columns in from the left and 15 columns in from the right: 


CALL GDDM('CHVMAR', 15,15) 
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CHXDAY, CHYDAY-Day Labels 


CHXDAY (day) 
CHYDAY (day) 


Specify English language, uppercase day labels for the currently selected axes. 
The specified day is associated with the first major scale mark position. Each 
successive day is assigned to the next major mark. See the comments under 
CHXMTH about label abbreviations. 


These calls implicitly set the corresponding label type to DATE. 


Valid only in state 1. 


Parameters 

day (4-byte binary integer) 
The day to be associated with the first major scale mark. Valid values are 1 
through 7. Monday is day 1. 


Coding Example 
In the following example, CHXDAY sets the first label (on the x axis) to Monday: 


CALL GDDM('CHXDAY',1) 
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CHXDTM, CHYDTM-Specify Translated Axis Lines or Datum Lines 


CHXDTM(x-value) 
CHYDTM(y-value) 


Specify a translated axis line or datum line to be drawn relative to the currently 
selected x axis or y axis. The x or y value must lie within the axis range. 


CHXDTM draws a line parallel to the y axis with the x-value parameter specifying 
the point of intersection with the x axis. 


CHYDTM draws a line parallel to the x axis with the y-value parameter specifying 
the point of intersection with the y axis. 


The color, line type, and line width are controlled by the current datum line attribute 
values, which can be specified by CHDATT. 


Translated axis lines: In state 1, the call specifies that a translated axis is to be 
constructed when the axis is constructed. /f CHYDTM is specified in state 1, the 
line drawn is the reference line to be used in place of the axis for all shaded charts. 
The line also acts as a baseline for bars of bar charts or risers of histograms. 


lf more than one call is made in state 1, the most recent is used. 


Datum lines: \|n state 2, the call results in an immediate construction of a datum 
line. More than one datum line can be added in state 2. Such lines have no effect 
on the shading of charts. 


Parameters 
x-value (short floating-point number) 
The x-axis value through which the line is to pass. 


y-value (short floating-point number) 
The y-axis value through which the line is to pass. 
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Coding Example 
The following example shows how to specify CHYDTM: 


CALL GDDM('CHYDTM',5.0) 


When used in state 1, CHYDTM has an effect like the following: 
9 — 


RV2F757-0 


Note that a line drawn with CHYDTM is parallel to the x axis. 
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CHXINT, CHYINT-—Specify Intercept 


CHXINT(x) 
CHYINT(y) 


Specify interception points for the currently selected axes. (Primary axes are 
selected by default.) CHXINT positions the y axis by giving the position on the x 
axis at which the y axis should cross it, and CHYINT positions the x axis by giving 
the position on the y axis where the x axis should cross. CHXINT is only brought 
into effect if CHYSET(INTERCEPT) is also specified. Similarly, CHYINT is only 
applied if CHXSET(INTERCEPT) is also specified. Ignored for pie charts and Venn 
diagrams. 


If the intercept value is outside the range when the axis is to be constructed, the 
range is extended to include it. Note that intercept values for logarithmic axes must 
be positive and nonzero. 


If CHXSET or CHYSET INTERCEPT is specified and CHXINT or CHYINT not 
used, a default intercept of 0 is assumed. 


Valid only in state 1. 


Parameters 
x (short floating-point number) 
The x-axis intercept. 


y (short floating-point number) 
The y-axis intercept. 


Coding Example 
The following example shows how to specify CHXINT: 


CALL GDDM('CHYINT',5.0) 
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CHXLAB, CHYLAB-Label Text 


CHXLAB(count,length,text) 
CHYLAB(count,length,text) 


Allow the specification of alphanumeric labels as a sequence of character strings. 
The labels are placed, in sequence, at major scale marks on the corresponding 
currently selected axis, starting with the scale mark with the algebraically lowest 
value. If the number of labels specified is less than the number of major scale 
marks on the axis, the sequence of labels is reused as necessary until each scale 
mark is associated with a label. 


CHXLAB can also be used for assigning a title to each pie of a pie chart. 


These commands implicitly cause calls to CHXSET(ALPHANUMERIC) and 
CHYSET(ALPHANUMERIC), and cause a logarithmic axis type specification to be 
ignored. 


CHSET(BLABEL) can be used to clear the areas occupied by labels, before they 
are written. 


The label text attributes can be set by CHLATT. 


Valid only in state 1. 


Parameters 
count (4-byte binary integer) 
The number of labels supplied. A specification of zero suppresses the labels. 


length (4-byte binary integer) 
The number of characters associated with each label. All labels must be the 
same length. Each label is centered on the corresponding axis position (scale 
mark position, or point midway between scale mark positions). Centering 
occurs after any trailing null (X'00') characters have been deleted. Hence the 
effect of varying-length labels can be obtained by using nulls as padding 
characters to extend each label to the standard length. 


text (character string) 
A character string that contains all of the labels, in order of use. The total 
length of the string must not exceed 32,000 characters. 


Coding Example 
The following example shows how to specify CHXLAB: 


CALL GDDM('CHXLAB',12,3, 'JANFEBMARAPRMAY JUNJULAUGSEPOCTNOVDEC' ) 


12 is the number of labels and 3 is the number of characters in each label. 
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CHXLAT, CHYLAT-Label Attributes 


CHXLAT(count,array) 
CHYLAT(count,array) 


Establish the default character-appearance attributes to be used in displaying labels 
for the currently selected axis. 


By default, the attributes are as follows: The defaults are: 


Color 0 (green on displays, black on printers, highest 
pen number on plotters) 

Character mode 3 

Symbol-set identifier 0 (system default) 

Character-size multiplier 100 (results in the text size as defined by 
CHCGRD (by default, the size of the hardware 
characters)) 


Character height/width multiplier 100 (results in the text size as defined by 
CHCGRD (by default, the size of the hardware 
characters)) 


Note rotation 0 


Valid only in state 1. 


Parameters 

count (4-byte binary integer) 
Specifies the number of elements in array. If more than six elements are 
specified, the excess elements are ignored. If fewer than six, the remainder 
are unchanged from their previous setting. If zero is specified, all six defaults 
are reinstated. 


array (an array of 4-byte binary integers) 
An array of, at most, six 4-byte binary integers: 


1. Color. 


For valid values of color, see Appendix C, “Colors, Line-Types, Markers, 
and Shading Patterns.” 


2. Character mode. 
Valid values are: 


0 system default (mode 3) 
2 mode 2 
3 mode 3 
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. Symbol-set identifier. 


For mode 2 or mode 38, the identifier denotes: 


0 the default character set 

8 Double-byte character set data (no shift-out or shift-in) 

n a graphics symbol set that has been previously loaded into GDDM by 
the application program using the GDDM call GSLSS 


. Character-size multiplier. 


This specification is ignored for character mode 1. For modes 2 and 3, the 
character-size multiplier is divided by 100, and the horizontal and vertical 
spacings or sizes specified by CHCGRD (or its defaults) are multiplied by 
this factor before the characters are drawn. For example, if character-size 
multiplier = 200 and mode-3 characters are being used, they are drawn 
twice as large as the basic size set by CHCGRD. The character-size 
multiplier must have a value greater than zero. 


. Character height/width multiplier. 


Specifies the height of the character box relative to its width. For example, 
100 indicates that the height is multiplied by the same amount as the width. 
200 causes the height to be multiplied by twice the amount of the width. 


. Axis-label rotation. 


When axis-label rotation is requested, each label is written at the specified 
angle to the horizontal. Label rotation is indicated by specifying a non-zero 
value in this element. The value must be from —9000 through +9000. This 
number is divided by 100 to give a value from —90 through +90, which is 
the angle, in degrees, to the horizontal at which the labels will be drawn. 
The default is zero. When positive, the angle is in a counterclockwise 
direction. When negative, it is in a clockwise direction. 


Coding Example 


The following example shows how to use CHXLAT: 


OPTION BASE 1 

INTEGER ATTAR 

DIM ATTAR(5) 

MAT READ ATTAR 

DATA 1,3,0,150,100 

CALL GDDM('CHPXLAT',5,ATTAR()) 


Differences between System/38 and the AS/400 System 
This call is not supported on System/38. 
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CHXMTH, CHYMTH-—Month Labels 


CHXMTH(month) 
CHYMTH(month) 


Specify English language, uppercase month labels for the currently selected x axis 
or y axis. The specified month is associated with the first major scale mark 
position. If CHXSET(NOSKIP), CHYSET(NOSKIP), or default month label skipping 
is in effect, each successive month is assigned to the next major mark. If 
CHXSET(SKIP) or CHYSET(SKIP) is specified, then months are assigned to major 
marks using the same skip factor that was specified on the CHXTIC or CHYTIC 
call. The labels normally are three-letter abbreviations, but a CHSET option is 
available to change this (see CHSET(ABREV)). 


These calls implicitly set the corresponding label type to DATE. 


Valid only in state 1. 


Parameters 

month (4-byte binary integer) 
The month to be associated with the first scale mark. Valid values are 1 
through 12. January is month 1. 


Coding Example 
The following example shows how to specify CHXMTH: 


CALL GDDM('CHXMTH',1) 


1 is the number of the month to start with (January). 
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CHXRNG, CHYRNG-Explicit Ranges 


CHXRNG (lower-limit,upper-limit) 
CHYRNG (lower-limit,upper-limit) 


Allow explicit specification of the ranges of the currently selected axes. When the 
range is not specified for a particular axis, or is specified as (n,n) (with lower and 
upper limit values identical), autoranging applies to the axis. In general, the second 
parameter is greater than the first, but you can change the direction of the axis by 
reversing the order of the parameters. Note that logarithmic axis ranges must have 
positive, nonzero values. 


Valid only in state 1. 


Parameters 

lower-limit,upper-limit (short floating-point numbers) 
The data values at the starting point and end point, respectively, of the x axis. 
For a horizontal x axis, the starting point data value is at the left, and the end 
point data value at the right. For a vertical x axis, the starting point data value 
is at the top of the axis, and the end point data value at the bottom of the axis. 


lower-limit,upper-limit (short floating-point number) 
The data values at the starting point and end point, respectively, of the y axis. 
For a vertical y axis, the starting point data value is at the bottom, and the end 
point data value at the top. For a horizontal y axis, the starting point data value 
is at the left, and the end point data value at the right. 


Coding Example 
The following example shows how to specify CHXRNG so that the x axis extends 
from a lower limit of 1 to an upper limit of 150: 


CALL GDDM('CHXRNG',1.0,150.0) 
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CHXSCL, CHYSCL-Scale Factor 


CHXSCL(scale-factor) 
CHYSCL(scale-factor) 


Specify a scale factor for numeric labels on the currently selected x axis or y axis. 
These calls specify that, when labels are generated from numeric values, the 
values should be multiplied by the scale factor before the labels are generated. 
This enables superfluous zeros to be suppressed. Scale factors are ignored for 
alphanumeric and date labeling. 


If a scaling factor is specified, it can be useful to include a notation in the axis title 
describing its use. For example, when the scaling factor is 0.001 and the data is in 
dollars, the axis title might be Thousands of Dollars. 


Valid only in state 1. 


Parameters 

scale-factor (short floating-point number) 
A scaling factor for each label to be generated. The value associated with 
each major scale mark is first multiplied by scale-factor. For example, if the 
value is 7000 and the factor is 0.001, the resulting label is 7. Scale-factor must 
have a value greater than zero. 


Coding Example 
The following example shows how to specify CHXSCL: 


CALL GDDM('CHXSCL',@.001) 
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CHXSEL, CHYSEL-Axis Selection 


CHXSEL(axis-number) 
CHYSEL(axis-number) 


Override the default axis selection to select the primary or secondary axis. By 
default the primary axis is selected. 


The selected pair of axes are those against which data is plotted by the plotting 
routines CHPLOT, CHSURF, CHHIST, and CHBAR. 


In addition, CHXSET or CHYSET options, and calls to CHXRNG, CHYRNG, 
CHXTTL, CHYTTL, CHXTIC, CHYTIC, CHXINT, CHYINT, CHXSCL, CHYSCL, 
CHXLAB, CHYLAB, CHXMTH, CHYMTH, CHXDAY, and CHYDAY apply to the 
selected axes. 


Valid in state 1 or state 2. 


Parameters 

axis-number (4-byte binary integer) 
The axis number to be selected. The integer must be 1 for the primary axis or 
2 for the secondary axis. The default is 1. 


Coding Example 
The following example shows how to specify CHXSEL: 


CALL GDDM('CHXSEL',2) 
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CHXSET, CHYSET-Specify Axis Option 


CHXSET(option) 
CHYSET(option) 


Control the drawing of currently selected axis lines when the chart is constructed. 


Note: Only one option can be used with one call. For example, if you want your x 
axis to be logarithmic and to have no tick marks you need to enter: 


CALL GDDM ('CHXSET','LOGA') 
CALL GDDM ('CHXSET','PLAIN') 


Valid only in state 1. 


Parameters 
Option (character) 


The string passed must be at least 4 characters long. Any characters over four 
are ignored, but might enhance the readability of the program. 


Function 
Axis, drawn or not 


Axis, intercept 


Axis, title position 


Grid, drawn or not 


Label position 


Label, skip months 


Label, type of 


Scale, linear or logarithmic 


Tick mark, style 


Zero forced into autorange 


Option 
AXIS 
NOAXIS 


LOWAXIS 
MIDDLE 
HIGHAXIS 
INTERCEPT 


ATCENTER 
ATEND 
ATABOVE 


GRID 
NOGRID 


LABADJACENT 
LABMIDDLE 
NOLAB 


SKIPMONTH 
NOSKIPMONTH 


NUMERIC 
ALPHANUMERIC 
DATE 


LINEAR 
LOGARITHMIC 


NTICK 
PTICK 
XTICK 
PLAIN 


FORCEZERO 
NOFORCEZERO 
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Options 
The groups of CHYSET options are listed below in alphabetic order: 


¢ 'ATCENTER' | 'ATEND' | 'ATABOVE’ 


Control the positioning or justification of the titles, or both, for the currently 
selected axis. 


ATCENTER specifies that the axis title is centered along the axis. 


ATEND specifies that the axis title is right-justified for a horizontal axis and 
justified to the top for a vertical axis. 


ATABOVE provides for placing the title above the vertical axis. 
For a horizontal axis, the ATABOVE specification is equivalent to ATEND. 


When both primary and secondary vertical axes are employed, and the titles 
are positioned above them, overlap may occur, depending on the distance 
between the axes and the title lengths. ATABOVE may cause the titles to 
overlap horizontal axis labels and scale marks, if the horizontal axis is at the 
top of the chart. 


ATABOVE may also cause overlap of the vertical axis labels and scale marks 
in some situations. The axis title is initially positioned with its baseline above 
the vertical axis. However, if the height of the axis title has been increased 
using the CHTATT call such that the title would extend above the top of the 
chart area, the baseline is moved down to a point where the axis title fits on the 
chart, thus possibly causing overlap with the vertical axis labels and scale 
marks. 


¢ 'AXIS' | 'NOAXIS' 


Control whether the currently selected axis lines are drawn when the chart is 
constructed. 


AXIS specifies that the axis line is to be drawn. 


NOAXIS specifies that the axis line should not be drawn. The axis title is not 
suppressed, nor are the scale marks and labels, unless they have been 
suppressed by other options. 


¢ 'FORCEZERO' | 'NOFORCEZERO' 


If autoranging applies, these options specify whether the range is to be 
extended, if necessary, to include zero. 


FORCEZERO specifies that the axis range is to be extended to include zero, if 
the range of the data does not. This option is ignored for logarithmic axes and 
for axes whose range is explicitly specified by a CHYRNG call. 


NOFORCEZERO suppresses the forced inclusion of zero in the range. 
¢ 'GRID' | 'NOGRID' 
Specify whether grid lines are to be constructed. 


CHYSET controls grid lines perpendicular to the y axis. Grid lines are 
constructed at the same time as their associated axes. Grid lines are 
positioned on major tick marks, whose positions are controlled by a CHYTIC 
call. The attributes of the grid lines are controlled by CHGATT. 


GRID specifies that grid lines are to be constructed when the axis is 
constructed. 
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NOGRID specifies that grid lines are not required. 
"LABADJACENT' | 'LABMIDDLE' | 'NOLAB' 


Specify label position for the currently selected y axis. These calls control the 
positioning of labels with respect to the major scale marks. 


LABADJACENT centers the label on the major scale-mark position, thus: 


190 195 200 205 


LABMIDDLE places the label between the major scale mark it is associated 
with and the preceding one. (The label that would normally be adjacent to the 
first mark on the axis is omitted.) The label is centered on the point midway 
between the two scale marks as shown below. This option is ignored for 
logarithmic axes. 


| 195 | 200 | 205 | 


NOLAB specifies that no labels are to be constructed for the corresponding 
axis. 


"LINEAR' | ‘LOGARITHMIC’ 
Specify whether the axis scale is linear or logarithmic (base 10). 


A logarithmic specification is ignored unless the axis label type is numeric. In 
particular, a logarithmic specification is ignored if alphanumeric labels are 
specified by means of CHYLAB. 


"LOWAXIS' | 'MIDDLE’ | "HIGHAXIS' | "INTERCEPT’ 


LOWAAXIS positions the selected axis at the bottom or left-hand side of the plot 
area. 


MIDDLE positions the selected axis in the middle of the plot area. 


HIGHAXIS positions the selected axis at the top or right-hand side of the plot 
area. 


INTERCEPT indicates that the position of the selected axis will be controlled by 
the CHYINT call referring to the other selected axis. CHYSET is used with 
CHXINT, and CHXSET with CHYINT. If the appropriate CHYINT (or CHXINT) 
call is not made, an intercept value of 0 is assumed. 


"NTICK’ | 'PTICK’ | "XTICK’ | "PLAIN' 


Specify whether tick marks are to be drawn on the axis and, if so, the style of 
drawing. The options apply to both major and minor scale marks, on the 
currently selected y axis. 


NTICK draws scale marks from the y axis in the negative direction of the x axis, 
as shown below. The positive direction of an axis is that defined by movement 
from the end of the axis with the algebraically lower value to the end with the 
algebraically higher value. The negative direction is the opposite. 
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PTICK reverses the scale-mark direction from that described for NTICK: 


XTICK draws scale marks perpendicular to the axis and crossing it, projecting 
equally on each side: 


PLAIN indicates that the axis is to be constructed without scale marks: 


Note: 'NTICK' is the default for primary axes, and 'PTICK' for secondary axes. 
e¢ "NUMERIC' | ‘ALPHANUMERIC’ | "DATE' 
Specify the labeling method used for the currently selected axis. 


NUMERIC specifies that a label is to be generated automatically for each major 
scale mark. The label is an EBCDIC representation of the numeric value along 
the axis defining the scale mark. The representation may be in fixed- or 
floating-point format. If in fixed-point format, you can control the format using 
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CHSET('NPGFS'), and CHSET('PGFS') calls. You can control scaling by 
using CHYSCL. 


ALPHANUMERIC specifies that each interval on the axis represents an item 
described by a label provided by a CHYLAB call. ALPHANUMERIC is implicitly 
set by a CHYLAB call. 


DATE implies that each interval on the axis is associated with a month of the 
year or a day of the week as specified by calls to CHYMTH and CHYDAY. 
DATE is implicitly set by these calls. 


If ALPHANUMERIC or DATE is specified, any logarithmic axis-type 
specification is ignored; the axis is forced to be linear. 


Note that all forms of labels correspond one-for-one with the major scale marks. 
The spacing of such marks along an axis is controlled by CHYTIC. 


‘SKIPMONTH' | 'NOSKIPMONTH' 
Specify whether or not month labels are to be skipped. 


NOSKIPMONTH (default) indicates that each successive month label is 
assigned to the next major tick mark. If CHXTIC(3,0) and CHXMTH(1) were 
specified with NOSKIPMONTH, the following might be output: 


| | | | 
Jan Feb Mar Apr May 


RV2F761-0 


SKIPMONTH indicates that month labels correspond to the major tick interval 
specified on the CHXTIC or CHYTIC call. If CHXTIC(3,0) and CHYMTH(1) 
were specified with SKIPMONTH, the following might be output: 


Jan Apr Jul Oct Jan 
RV2F762-0 
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CHXTIC, CHYTIC—Scale Mark Interval 


CHXTIC(major,minor) 
CHYTIC(major, minor) 


Override the default positions of major and minor scale marks (also known as tick 
marks) on the currently selected x axes and y axes. CHXTIC is ignored for bar 
charts. 


By default, the interval on a linear axis is 1, 2, or 5 multiplied by some power of 10 
so as to separate the major marks by approximately 9-character cell widths. Minor 
marks are never generated for logarithmic axes. 


The default for logarithmic axes place a major mark at each power of 10 over the 
range of the axis; for example: 1, 10, 100, 1000, and so forth. Minor specifications 
are ignored, because minor marks cannot be generated for logarithmic axes. 


The above default actions are taken if no CHXTIC or CHYTIC call is issued. 


Valid only in state 1. 


Parameters 

major 
A short floating-point number that specifies the interval between major scale 
marks. If zero is specified, the default action is taken. Linear and logarithmic 
axes are treated differently. 


Linear axes 
Linear axes can have both minor and major scale marks. The major scale 
marks are placed at the interval specified by the major parameter. 


Logarithmic axes 
Logarithmic axes, if they have any major scale marks, always have them at 
powers of 10. CHXTIC and CHYTIC are used to define extra tick marks 
between the powers of 10. 


Only the high-order digit of the parameter has any effect. The high-order 
digit specifies at which multiples of power of 10 such extra marks should be 
drawn. 


Assume a logarithmic axis with a range of 1 to 100 (remember, there is no 
0 on a logarithmic axis). Tick marks would be placed at the points shown 
in the following table: 
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CHXTIC or Major Scale Mark Points 

CHYTIC Value Assuming an Axis Range of 1 to 100 

0 1,10,100 

1 1,2,3,4,5,6,7,8,9,10,20,30,40,50,60,70,80,90,100 
2 1,2,4,6,8,10,20,40,60,80, 100 

3 1,3,6,9,10,30,60,90,100 

4 1,4,8,10,40,80,100 

5 1,5,10,50,100 

6 1,6,10,60,100 

vA 1,7,10,70,100 

8 1,8,10,80,100 

9 1,9,10,90,100 

10 1,2,3,4,5,6,7,8,9,10,20,30,40,50,60,70,80,90,100 


Method of determining logarithmic scale marks: If marks are required on a 
logarithmic axis, each power of 10 receives a major mark, and additional 
intermediate major marks are placed at a frequency corresponding to the high-order 
digit (base 10) of the major interval specification. This correspondence is as 
follows. If the digit is n, then in the interval between 10**i and 10**(i+1), major 
marks are placed at each point defined by the following equation: 


P=j*n*10** i 
for j=1,2,3,...9, when (j*n)<10 


Each power-of-10 scale mark is labeled in full. Intermediate scale marks are 
labeled with a digit in the range 2 through 9. This is the multiplication factor that 
must be applied to the immediately lower power-of-10 label to derive the value of 
the scale mark. 


minor (short floating-point number; must be an integer) 
The number of minor marks between major marks. If zero is specified, no 
minor marks are drawn. Minor marks can be specified even though major 
marks are automatically generated (when the major parameter is 0). The 
maximum number of minor marks that can be specified is 2048. 


Minor marks are drawn half the length of major marks. Minor marks are never 
drawn for logarithmic axes, so the parameter is ignored. 


Coding Example 
The following example shows how to specify CHXTIC for major ticks every 40 
intervals and minor ticks every 4 intervals: 


CALL GDDM('CHXTIC', 40,4) 
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CHXTTL, CHYTTL-—Axis Title Specification 


CHXTTL(length,text) 
CHYTTL(length,text) 


Specify titles for the currently selected axes. 
To change the appearance of the characters in the titles, see CHTATT. 


Valid only in state 1. 


Parameters 

length (4-byte binary integer) 
The number of characters in the title. A length of zero suppresses the title. 
The length must not exceed 32,000. 


text (character string) 
Specifies the character string to be used as a title. 


Coding Example 
The following example shows how to specify CHXTTL and CHYTTL: 


CALL GDDM('CHXTTL',12,'X axis Title’) 
CALL GDDM('CHYTTL',12,'Y axis Title’) 
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CHY... — y Axis Calls 


All CHY... calls are listed under the equivalent CHX.... For example, CHYSCL is 
described with CHXSCL. 


CHY.......... (see equivalent CHX.... call) 
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Summary of Data Types for Presentation Graphics Routines 


Figure 3-3 is a table in which you can look up the parameter data types for the 
Presentation Graphics routines. For instance, for CHAATT, there are two 
parameters: the first is a 4-byte binary integer and the second is an array of 4-byte 
binary integers. 


Figure 3-3 (Page 1 of 2). Summary of Data Types for Presentation Graphics 
Routines 

Name Parm 1 Parm 2 Parm 3 Parm 4 Parm 5 
CHAATT in in arr 

CHAREA fp fp fp fp 
CHBAR in in fp arr 

CHBATT in in arr 

CHCGRD in in 

CHCOL in in arr 

CHDATT in in arr 

CHDRAX 

CHFINE in 

CHGAP fp 

CHGATT in in arr 

CHGGAP fp 

CHHATT in in arr 

CHHEAD in char 

CHHIST in in fp arr fp arr fp arr 
CHHMAR in in 

CHKATT in in arr 

CHKEY in in ch 

CHKEYP ch ch ch 

CHKMAX in in 

CHKOFF fp fp 

CHLATT in in arr 

CHLT in in arr 

CHLW in fp arr 

CHMARK in in arr 

CHNATT in in arr 

CHNOFF fp fp 

CHNOTE ch in ch 

CHNUM in 

CHPAT in in arr 

CHPCTL in fp arr 

CHPEXP in fp arr 

CHPIE in in fp arr 

CHPIER in 
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Figure 3-3 (Page 2 of 2). Summary of Data Types for Presentation Graphics 


Routines 

CHPLOT in in fp arr fp arr 
CHRNIT 

CHSET ch 

CHSTRT 

CHSURF in in fp arr fp arr 
CHTATT in in arr 

CHTERM 

CHVATT in in arr 

CHVCHR in 

CHVENN fp fp fp 

CHVMAR in in 

CHXDAY in 

CHYDAY in 

CHXDTM fp 

CHYDTM fp 

CHXINT fp 

CHYINT fp 

CHXLAB in in ch 

CHYLAB in in ch 

CHXLAT in in arr 

CHYLAT in in arr 

CHXMTH in 

CHYMTH in 

CHXRNG fp fp fp fp 
CHYRNG fp fp fp fp 
CHXSCL fp 

CHYSCL fp 

CHXSEL in 

CHYSEL in 

CHXSET ch 

CHYSET ch 

CHXTIC fp fp 

CHYTIC fp fp 

CHXTTL in ch 

CHYTTL in ch 


in = 4-byte binary integer 

fp = Short floating point number 
ch = Character string 

arr = Array 


var = Variable (whose value is returned by GDDM) 
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Appendix A. Conversion and Compatibility 


Compatibility with the System/370 Computer 
GDDM on the AS/400 system is a compatible subset and adaptation of Version 1, 
Release 3 of the System/370 GDDM licensed program. 


The Presentation Graphics routines are a compatible subset of GDDM-PGF (GDDM 
Presentation Graphics Facility), which is a System/370 GDDM licensed program. 


The Application Programming Interface on the AS/400 system is equivalent to the 
nonreentrant interface on the System/370 computer. 


Summary of GDDM Functions 


This section (Figure A-1 through Figure A-24) presents a listing, by function call, of 
the differences between the System/370 computer and the AS/400 system. 


In this section, the right column shows changes from the System/370 licensed 
program: 

D: Deleted in the AS/400 version 

M: Modified for the AS/400 version 

R: Restricted in the AS/400 version 

A: Added to the AS/400 version 


Control Functions 


Figure A-1. Control Functions 


Name Description AS/400 
Support 
DSCMF Control mode function D 


DSQCMF Query control mode function D 
ESEUDS Encoded user default specification D 
ESLIB Identify library D 
ESPCB Identify PCB (IMS/VS only) D 
ESSUDS Source user default specification D 
FSEXIT Specify error exit M 
FSINIT Initialize graphics 

FSQERR Query last error M 
FSRNIT Reinitialize 

FSTERM End graphics 

FSTRCE Internal trace control 

SPINIT Initialize with SPIB 
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Device Functions 


Figure A-2. Device Functions 

Name Description AS/400 
Support 

DSCLS Close device R 

DSDROP Discontinue device usage R 

DSOPEN Open device M 

DSQDEV Query device characteristics 

DSQUID Query unique device-id 

DSQUSE Query device usage 

DSRNIT Reinitialize device R 

DSUSE Specify device usage R 

FSCLS Close alternative device D 

FSOPEN Open alternative device D 

FSQDEV Query device characteristics 

FSQURY Query device characteristics D 

GSENAB Enable or disable a logical input device 

Input/Output Functions 

Figure A-3. Input/Output Functions 

Name Description AS/400 
Support 

ASREAD Device output/input 

FSALRM Sound device alarm 

FSCHEK Check picture complexity before output D 

FSFRCE Update the display 

FSQUPDM | Query update mode D 

FSREST Retransmit data R 

FSSAVE Save current picture contents D 

FSSHOR Extended FSSHOW D 

FSSHOW Display a saved picture D 

FSUPDM Set update mode D 

GSREAD Await graphics input D 

MSREAD Present mapped data D 
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Figure A-4. Symbol Set Functions 


Name Description AS/400 
Support 

ASCSS Character symbol sets 

ASFPSS Define primary symbol set for field 

GSCPG Set current code page D 

GSDSS Load graphics symbol set from program D 

GSLSS Load graphics symbol set R 

GSQCPG Query current/associated code page D 

GSQNSS Query how many loaded symbol sets 

GSQSS Query number of symbol sets loaded R 

GSQSSD Query symbol set data D 

GSRSS Release a graphics symbol set R 

PSDSS Load alpha symbol set from program D 

PSLSS Load alpha symbol set from storage D 

PSLSSC Load alpha symbol set from storage if needed D 

PSQSS Query device store status D 

PSRSS Release a symbol set from PS store D 

PSRSV Reserve or free a PS store D 

SSQF Query symbol set on auxiliary storage D 

SSREAD Read a symbol set from auxiliary storage D 

SSWRT Write symbol set D 

Page Handling Functions 

Figure A-5. Page Handling Functions 

Name Description AS/400 
Support 

FSPCLR Clear the current page 

FSPCRT Create a page 

FSPDEL Delete a page 

FSPQRY Query specified page 

FSPSEL Select a page 

FSPWIN Set page window D 

FSQCPG Query current page id 

FSQUPG Query unique page id 

FSQWIN Query page window 

MSPCRT Create a page for mapping 
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Partition Functions 


Figure A-6. Partition Functions 
Name Description AS/400 
Support 
PTNCRT Create a partition D 
PTNDEL Delete a partition D 
PTNMOD Modify the current partition D 
PTNSEL Select a partition D 
PTSCRT Create a partition set D 
PTSDEL Delete a partition set D 
PTSSEL Select a partition set D 
Partition Query Functions 
Figure A-7. Partition Query Functions 
Name Description AS/400 
Support 
PTNQRY Query the current partition D 
PTSQRY Query partition set attributes D 
PTSQUN Query unique partition set id D 
Mapping Functions 
Figure A-8. Mapping Functions 
Name Description AS/400 
Support 
MSCPOS Set cursor position D 
MSDFLD Create a mapped field D 
MSGET Get data from mapped field D 
MSPCRT Create a page for mapping D 
MSPUT Put data into a mapped field D 
Mapping Query Functions 
Figure A-9. Mapping Query Functions 
Name Description AS/400 
Support 
MSPQRY Query current page D 
MSQADS Query application data structure definition D 
MSQFIT Query map fit D 
MSQFLD Query mapped field D 
MSQGRP Query map group characteristics D 
MSQMAP Query map characteristics D 
MSQMOD | Query modified fields D 
MSQPOS Query cursor position D 


A-4 —AS/400 GDDM Reference 


Alphanumeric Field Functions 


Figure A-10. Alphanumeric Field Functions 


Name Description 


ASCCOL Character colors in field 


AS/400 
Support 


ASCGET Get field contents 


ASCHLT Character highlights 


ASCPUT Specify field contents 


ASCSS Character symbol sets 


ASDFLD Define a single field 


ASDFLT Set default field attributes 


ASDFMT Define multiple fields 


ASDTRN Define I/O translation tables 


ASFBDY Field outline attributes 


ASFCLR Clear fields 


ASFCOL Define field color 


ASFCUR Position the cursor 
ASFEND Define field end attribute 


ASFHLT Define field highlighting 


ASFIN Define input null-to-blank conversion 


ASFINT Define field intensity 


ASFMOD Change field status 


ASFOUT Define output blank-to-null conversion 


ASFPSS Define primary symbol set for a field 


ASFSEN Define field shift controls 
ASFTRA Define field transparency attribute 


ASFTRN Assign translation table set to a field 


ASFTYP Define field type 


ASGGET Get data from dual character field 


ASGPUT Put data in dual character field 


ASMODE Define the operator reply mode 


ASRATT Define field attributes 


ASRFMT Redefine fields 


ASTYPE Override alphanumeric character-code assignments 


VIVUIJVUJVIJVIVSVJVIVIJVIJVIVIJVIJVIVIJVIJVJUSVIJVUJSVUSVIJVUsSVUSVJVJV}SVIV 
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Query Alphanumeric Fields 


Figure A-11. Query Alphanumeric Fields 

Name Description AS/400 
Support 

ASQCOL Query character colors D 

ASQCUR Query cursor position D 

ASQFLD Query field attributes D 

ASQHLT Query character highlights D 

ASQMAX Query the number of fields D 

ASQMOD Query modified fields D 

ASQNMF Query number of numeric fields D 

ASQSS Query character symbol set D 

Graphics Field Control 

Figure A-12. Graphics Field Control 

Name Description AS/400 
Support 

GSCLP Enable and disable clipping 

GSCLR Clear the graphics field 

GSFLD Define the graphics field 

GSPS Define the picture space 

GSSCLS Close the current segment 

GSSDEL Delete a segment 

GSSEG Create a segment 

GSUWIN Define a uniform window D 

GSVIEW Define a viewport 

GSWIN Define a window 

Graphics Field Character Handling 

Figure A-13. Graphics Field Character Handling 

Name Description AS/400 
Support 

GSCA Set current character angle 

GSCB Set character box size 

GSCD Set current character direction 

GSCH Set character shear 

GSCM Set current character mode R 
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Graphics Color, Symbol Set, Line, Marker 


Figure A-14. Graphics Color, Symbol Set, Line, Marker 


Name Description AS/400 
Support 
GSCOL Set current color 
GSCS Set current symbol set identifier 
GSFLW Set fractional line width 
GSLT Set current line type 
GSLW Set current line width 
GSMB Set current marker box size D 
GSMIX Set current color mixing mode 
GSBMIX Set background mix 
GSMS Set current marker symbol 
GSMSC Set marker scale 
GSPAT Set current shading pattern R 
GSSEN Set mixed-string attribute of graphics text 
Graphics Drawing Functions 
Figure A-15. Graphics Drawing Functions 
Name Description AS/400 
Support 
GSARC Draw circular arc 
GSAREA Start shaded area 
GSCHAP Draw character string at current position 
GSCHAR Draw character string at specified point 
GSCP Set current position 
GSDEFS Start drawing defaults definition 
GSDEFE End drawing defaults definition 
GSELPS Draw an elliptical arc 
GSENDA End a shaded area 
GSIMG Draw a graphics image 
GSIMGS Draw scaled graphics image 
GSLINE Draw a straight line 
GSMARK Draw a marker symbol 
GSMOVE Move without drawing 
GSMRKS Draw a series of marker symbols 
GSPFLT Draw a curved fillet 
GSPLNE Draw a series of lines 
GSVECM Draw vectors 
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Retrieve and Display Graphics Data 


Figure A-16. Retrieve and Display Graphics Data 

Name Description AS/400 
Support 

GSGET Retrieve graphics data 

GSGETE End retrieval of graphics data 

GSGETS Start retrieval of graphics data 

GSLOAD Load segments D 

GSPUT Display retrieved graphics data 

GSSAVE Segment save D 

Graphics Query Functions 

Figure A-17. Graphics Query Functions 

Name Description AS/400 
Support 

GSQBMIX | Query background mix D 

GSQCA Query character angle 

GSQCB Query character box size 

GSQCcD Query character direction 

GSQCEL Query hardware cell size 

GSQCH Query character shear 

GSQCLP Query the clipping state 

GSQCM Query the current character mode 

GSQCOL Query the current color 

GSQCP Query the current position 

GSQcs Query the current symbol set 

GSQCUR Query the cursor position 

GSQFLD Query graphics field D 

GSQFLW Query fractional line width 

GSQLT Query the current line type 

GSQLW Query the current line width 

GSQMAX Query the number of segments 

GSQMB Query marker box size D 

GSQMIX Query the current color mixing mode 

GSQMS Query the current marker symbol 

GSQMSC Query marker scale 

GSQPAT Query the current shading pattern 

GSQPS Query the picture space definition 

GSQSEN Query the mixed-string attribute of graphics text 

GSQTB Query the text box 

GSQVIE Query the current viewport definition 

GSQWIN Query the current window definition 
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Interactive Graphics Functions 


Figure A-18. Interactive Graphics Functions 


Name Description AS/400 
Support 
GSCORR Correlate segment/tag pair 
GSENAB Enable/disable logical input device D 
GSFLSH Clear graphics input queue D 
GSIDVF Clear data value, float D 
GSIDVI Clear data value, integer D 
GSILOC Initialize locator D 
GSIPIK Initialize pick D 
GSISTK Initialize stroke D 
GSISTR Initialize string D 
GSSATI Set initial segment attributes D 
GSSATS Modify segment attributes D 
GSSPOS Set segment position D 
GSTAG Set current primitive tag D 
Interactive Graphics Query Functions 
Figure A-19. Interactive Graphics Query Functions 
Name Description AS/400 
Support 
GSQATI Query initial segment attributes 
GSQCHO Query choice device data D 
GSQLID Query logical input device D 
GSQLOC Query graphics locator data D 
GSQPIK Query pick data D 
GSQSIM Query simultaneous queue entry D 
GSQSTK Query stroke data D 
GSQSTR Query string data D 
GSQTAG Query current tag D 
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Copy Functions 


Figure A-20. Copy Functions 
Name Description AS/400 
Support 
FSCLS Close alternative device D 
FSCOPY Send page to alternative device D 
FSLOG Send character string to alternative device D 
FSLOGC Send character string with carriage control to alternative device D 
FSOPEN Open alternative device D 
GSCOPY Send graphics to alternative device D 
GSARCC Aspect ratio control on copy D 
Color Table Functions 
Figure A-21. Color Table Functions 
Name Description AS/400 
Support 
GSCTD Define color table A 
GSQCTD Query color table definition A 
GSCT Select color table A 
GSQCT Query color table A 
GSDCT Define a color table D 
GSQUCT Query currently used color table D 
GSUCT Use a color table D 
Graphics Segment Functions 
Figure A-22. Graphics Segment Functions 
Name Description AS/400 
Support 
GSQATS Query segment attributes D 
GSQPOS Query segment position D 
GSSAGA Set all geometric attributes D 
GSSATI Set initial segment attributes D 
GSSATS Modify segment attributes D 
GSSCLS Close the current segment 
GSSCPY Segment copy D 
GSSDEL Delete a segment 
GSSEG Create a segment 
GSSINC Segment include 
GSSORG Set segment origin D 
GSSPOS Set segment position D 
GSSPRI Segment priority D 
GSSTFM Set segment priority D 
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Graphics Segment Query Functions 


Figure A-23. Graphics Segment Query Functions 

Name Description AS/400 
Support 

GSQAGA Query all geometric attributes 

GSQATI Query initial segment attributes D 

GSQATS Query segment attributes D 

GSQMAX Query the number of segments D 

GSQORG Query segment origin D 

GSQPOS Query segment position D 

GSQPRI Query segment priority D 

GSQTFM Query segment transform D 

Environment 

Figure A-24. Environment 

Name Description AS/400 
Support 

FSQSYS Query systems environment D 


Summary of Presentation Graphics Routines 
This section (Figure A-25 through Figure A-34) lists the functions provided by the 
Presentation Graphics routines, which include all API functions from the 
System/370 licensed program except those which invoke the GDDM-PGF 
Interactive Chart Utility. Presentation Graphics routines are all prefixed with CH. 


In this section, the right-hand column shows changes from the System/370 licensed 
program: 

D: Deleted in the AS/400 system version 

M: Modified for the AS/400 system version 

R: Restricted in the AS/400 system version 


The modifications are primarily restrictions in the Presentation Graphics routines 
caused by restrictions in GDDM. For example, on all of the text attributes 
functions, character types 1 and 2 are not supported because OS/400 Graphics 
does not support them. 


Control Functions 


Figure A-25. Control Functions 


Name Description AS/400 
Support 


CHSTRT Reset the processing state 


CHRNIT Reinitialize Presentation Graphics routines 


CHTERM Terminate Presentation Graphics routines 
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Chart Definition Functions 
Chart Layout Specifications 


Figure A-26. Chart Layout Specifications 


Name Description AS/400 
Support 
CHAREA Chart area 
CHQARE Query chart area D 
CHBATT Set framing box attributes 
CHCGRD Basic character spacing/size 
CHCNST Constant outlines around chart data D 
CHHMAR Horizontal chart margins 
CHVMAR Vertical chart margins 
Legend Specifications 
Figure A-27. Legend Specifications 
Name Description AS/400 
Support 
CHKEYP Legend position 
CHKEY Legend key labels 
CHKATT Legend text attributes 
CHXLAT x-axis label attributes 
CHYLAT y-axis label attributes 
CHKMAX Maximum legend width/height 
CHKOFF Legend offsets 
Note Specifications 
Figure A-28. Note Specifications 
Name Description AS/400 
Support 
CHNOFF Offsets for chart note 
CHNOTE Construct a chart note 
CHCONV Convert coordinates D 
CHNATT Note text attributes R 
CHQPOS Query positional information D 
CHSSEG Set segment identifier range D 
Chart Heading 
Figure A-29. Chart Heading 
Name Description AS/400 
Support 
CHHEAD Heading text 
CHHATT Heading text attributes R 
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Axis Specifications 


Figure A-30. Axis Specifications 


Name Description AS/400 
Support 

CHXSET x-axis characteristics R 

CHYSET y-axis characteristics R 

CHZSET z-axis option D 

CHXINT x-axis intercept 

CHYINT y-axis intercept 

CHXRNG x-axis explicit range 

CHYRNG y-axis explicit range 

CHQRNG Query axis range D 

CHZRNG z-axis explicit range 

CHXTIC x-axis scale mark interval 

CHYTIC y-axis scale mark interval 

CHZTIC z-axis scale mark interval D 

CHAATT Axis line attributes 

CHTATT Axis title text attributes 

CHXTAT x-axis title attributes 

CHYTAT y-axis title attributes 

CHXLAT x-axis label attributes 

CHYLAT y-axis label attributes 

CHZLAT z-axis label attributes D 

CHXTTL x-axis text specification 

CHYTTL y-axis text specification 

CHXSCL x-axis scale factor 

CHYSCL y-axis scale factor 

CHLATT Axis label text attributes R 

CHXLAB x-axis label text 

CHYLAB y-axis label text 

CHXDLB x-axis data labels 

CHZDLB z-axis data labels 

CHXMTH x-axis month labels 

CHYMTH y-axis month labels 

CHXDAY x-axis day labels 

CHYDAY y-axis day labels 
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Grid and Datum Lines 


Figure A-31. Grid and Datum Lines 

Name Description AS/400 
Support 

CHGATT Grid line attributes 

CHXDTM x datum line 

CHYDTM y datum line 

CHDATT Datum line attributes 

Component Attribute Tables 

Figure A-32. Component Attribute Tables 

Name Description AS/400 
Support 

CHCOL Component color table 

CHLT Component line type table 

CHMARK Component marker table M 

CHMKSC Set marker scale values D 

CHPAT Component shading pattern table M 

CHLC Component line color table D 

Chart Appearance Options 

Figure A-33. Chart Appearance Options 

Name Description AS/400 
Support 

CHSET Set chart appearance option R 
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Chart Construction Routines 
Chart Routines 


Figure A-34. Chart Routines 


Name Description AS/400 
Support 

CHFINE Curve fitting smoothness 

CHDRAX Specific control of axis drawing 

CHPLOT Line graphs and scatter plots 

CHSURF Surface charts 

CHHIST Histograms 

CHNUM Set number of chart components 

CHBAR Bar charts 

CHBARX Bar charts with numeric x-axis D 

CHGAP Spacing between bars 

CHGGAP Spacing between bar groups 

CHZGAP z-axis bar gap ratio D 

CHVCHR Number of bar value characters 

CHVATT Value text attributes 

CHTHRS Bar value threshold limit 

CHVDIG Decimal digits in bar values 

CHPIE Pie charts 

CHPIER Size specification 

CHPCTL Control pie chart slices 

CHPEXP Exploded pie chart slices 

CHVENN Venn diagram 

CHPOLR Polar charts D 

CHTOWR Tower charts D 

CHTPRJ Set projection for tower charts D 

CHDTAB Plot table chart D 

CHDCTL Data table control values D 
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RCP Codes 


This section provides a list of request control parameter (RCP) codes supported by 
the AS/400 system. RCP codes can be used instead of the function name when 
calling OS/400 Graphics functions from BASIC, RPG III, and COBOL/400 
programming languages. (RCP codes are required only for compatibility with IBM 
BASIC.) RCP codes, like function names, are passed as parameters on a CALL 
GDDM statement, but they must be defined as 4-byte binary integers. For 
example, for GSCHAR in BASIC, the following are equivalent: 


CALL GDDM('GSCHAR', 50.0, 50.0, 23, ‘Sample character string') 
and 
CALL GDDM(202114304, 50.0, 50.0, 23, 'Sample character string') 


Also, RCP codes (as well as the function name) are set by OS/400 Graphics in 
error records passed to user error exits, or produced in response to FSQERR calls. 


RCP Codes for GDDM 
The RCP codes for GDDM are: 


Name RCP code Description 

FSEXIT 196608 Specify an error exit and/or error severity 
FSQERR 262144 Query last error 

FSTERM 201326592 Terminate graphics 

FSINIT 201326593 Initialize graphics 

FSRNIT 201326594 Reinitialize graphics 

DSOPEN 201327104 Open device 

DSCLS 201327105 Close device 

DSUSE 201327106 Specify device usage 

DSDROP 201327107 Discontinue device usage 
DSQDEV 201327110 Query device characteristics 
DSQUID 201327108 Query unique device-id 

DSQUSE 201327109 Query device usage 

DSRNIT 201327111 Reinitialize device 

FSPCRT 201588736 Create a page 

FSPSEL 201588737 Select a page 

FSPDEL 201588738 Delete a page 

FSPCLR 201588739 Clear the current page 

FSPQRY 201588740 Query specified page 

FSQCPG 201588741 Query current page-id 

GSQNSS 201588994 Query the number of loaded symbol sets 
GSQSS 201588995 Query loaded symbol sets 
GSLSS 201589504 Load a graphics symbol set 
GSRSS 201589761 Release a graphics symbol set 
FSQDEV 201590016 Query device characteristics 
FSQUPG 201591040 Query unique page-id 

FSALRM 201850880 Sound device alarm 

FSREST 201853952 Retransmit data 

GSFLD 202113024 Define the graphics field 

GSPS 202113025 Define the picture space 

GSWIN 202113026 Define a window 

GSVIEW 202113027 Define a viewport 

GSQPS 202113028 Query the picture space definition 
GSQVIE 202113029 Query the current viewport definition 
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Name 


GSQWIN 
GSQMAX 
GSQCUR 
GSQCEL 
GSCLP 
GSQCLP 
GSSEG 
GSSCLS 
GSSDEL 
GSCLR 


GSMOVE 
GSLINE 
GSPLNE 
GSMARK 
GSMRKS 
GSAREA 
GSENDA 
GSVECM 
GSCHAR 
GSCHAP 
GSQTB 
GSARC 
GSELPS 
GSPFLT 


GSQCP 
GSCOL 
GSMIX 
GSLT 
GSLW 
GSCM 
GSCS 
GSCB 
GSCA 
GSCD 
GSPAT 
GSMS 
GSCH 
GSFLW 
GSQFLW 
GSSEN 
GSQCOL 
GSQMIX 
GSQLT 
GSQLW 
GSQCM 
GSQCS 
GSQCB 
GSQCA 
GSQCD 
GSQPAT 
GSQMS 
GSQCH 
GSMSC 
GSQMSC 
GSQSEN 
GSIMG 
GSIMGS 


ASREAD 
FSFRCE 


GSCTD 
GSQCTD 


RCP code 


202113030 
202113280 
202113281 
202113538 
202113539 
202113540 
202113792 
202113793 
202113794 
202113795 


202114048 
202114049 
202114050 
202114054 
202114055 
202114056 
202114057 
202114058 
202114304 
202114305 
202114306 
202114560 
202114561 
202114562 


202114816 
202114817 
202114818 
202114819 
202114820 
202114821 
202114822 
202114823 
202114824 
202114825 
202114826 
202114827 
202114828 
202114830 
202114831 
202114832 
202114833 
202114834 
202114835 
202114836 
202114837 
202114838 
202114839 
202114840 
202114841 
202114842 
202114843 
202114844 
202114845 
202114846 
202114847 
202115584 
202115588 


202375168 
202375169 


202117377 
202117378 


Description 


Query the current window definition 
Query the number of segments 
Query the cursor position 

Query hardware cell size 

Enable and disable clipping 

Query the clipping mode 

Create a segment 

Close the current segment 

Delete a segment 

Clear the graphics field 


Move without drawing 

Draw a straight line 

Draw a series of lines 

Draw a marker symbol 

Draw a series of marker symbols 
Start a shaded area 

End a shaded area 

Vectors 


Draw a character string at a specified point 
Draw a character string at the current position 


Query the text box 
Draw a circular arc 
Draw an elliptic arc 
Draw a curved fillet 


Query the current position 

Set current color 

Set current color mixing mode 

Set current line type 

Set current line width 

Set current character mode 

Set current symbol set 

Set current character box size 

Set current character angle 

Set current character direction 

Set current shading pattern 

Set current marker symbol 

Set current character shear 

Set the fractional line width 

Query the current floating point line width 
Set mixed-string attribute of graphics text 
Query the current color 

Query the current color mixing mode 
Query the current line type 

Query the current line width 

Query the current character mode 
Query the current symbol set 

Query the current character box 
Query the current character angle 
Query the current character direction 
Query the current shading pattern 
Query the current marker symbol 
Query the current character shear 
Set marker scale 

Query marker scale 


Query mixed-string attribute of graphics text 


Draw graphics image 
Draw scaled graphics image 


Device output/input 
Force output 


Define color table 
Query color table definition 
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Name 


GSCT 


GSQCT 


RCP code 


202117379 
202117380 


Description 


Select color table 
Query color table 


RCP Codes for Presentation Graphics Routines 
The RCP codes for the Presentation Graphics routines are: 


Name 


CHTERM 
CHRNIT 
CHSET 
CHKEY 
CHHEAD 
CHMARK 


CHLT 


CHCOL 
CHPAT 


CHLW 


CHPEXP 
CHXSET 
CHYSET 
CHXTTL 
CHYTTL 
CHXLAB 
CHYLAB 
CHXSCL 
CHYSCL 
CHXMTH 
CHYMTH 
CHXDAY 
CHYDAY 
CHNUM 
CHGAP 
CHGGAP 
CHHMAR 
CHVMAR 
CHPIER 
CHCGRD 
CHVCHR 
CHFINE 
CHAATT 
CHGATT 
CHKEYP 
CHHATT 
CHTATT 
CHLATT 
CHKATT 
CHVATT 
CHXLAT 
CHYLAT 
CHAREA 
CHXRNG 
CHYRNG 
CHXINT 
CHYINT 
CHXTIC 
CHYTIC 
CHKOFF 
CHKMAX 
CHNOFF 
CHNATT 
CHDATT 
CHBATT 
CHBAR 
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RCP code 


268435712 
268501248 
268566785 
268567041 
268567042 
268567297 
268567298 
268567299 
268567300 
268567301 
268567302 
268567553 
268567554 
268567809 
268567810 
26856781 1 
268567812 
268568071 
268568072 
268568073 
268568074 
268568075 
268568076 
268568079 
268568080 
268568081 
268568082 
268568083 
268568084 
268568085 
268568086 
268568090 
268568321 
268568322 
268568577 
268568833 
268568834 
268568835 
268568837 
268568838 
268568839 
268568840 
268569090 
269092353 
269092354 
269092355 
269092356 
269092357 
269092358 
269092376 
269092377 
269157911 
269158660 
269158913 
269158915 
269289985 


Description 


Terminate Presentation Graphics routines 
Reinitialize Presentation Graphics routines 
Specify chart options 

Legend key labels 

Heading text 

Component marker table 
Component line type table 
Component color table 
Component shading pattern table 
Component line width table 
Control pie chart slices 

Specify x-axis options 

Specify y-axis options 

x-axis title specification 

y-axis title specification 

x-axis label text 

y-axis label text 

Set x-axis scale factor 

Set y-axis scale factor 

Set x-axis month labels 

Set y-axis month labels 

Set x-axis day labels 

Set y-axis day labels 

Set number of components 

Set spacing between bars 

Set spacing between bar groups 
Set horizontal margins 

Set vertical margins 

Set pie reduction 

Basic character spacing/size 
Number of characters in bar values 
Curve fitting smoothness 

Set axis attributes 

Set grid line attributes 

Set legend base position 

Set heading text attributes 

Set axis title text attributes 

Set axis label text attributes 

Set legend text attributes 

Set values attributes 

x-axis label attributes 

y-axis attributes 

Set chart area 

Set x-axis explicit range 

Set y-axis explicit range 

Set x-axis intercept 

Set y-axis intercept 

Set x-axis tick mark interval 

Set y-axis tick mark interval 

Set legend offsets 

Set maximum legend width/height 
Specify offsets for CHNOTE 

Set note attributes 

Set datum line attributes 

Set framing box attributes 

Plot a bar chart 


Name 


CHHIST 
CHPLOT 
CHSURF 
CHVENN 
CHPIE 
CHXDTM 
CHYDTM 
CHXSEL 
CHYSEL 
CHSTRT 
CHNOTE 
CHDRAX 
CHPCTL 


RCP code 


269289986 
269289987 
269289988 
269289989 
269289990 
269354509 
269354510 
269420545 
269420546 
269549824 
269680896 
269746432 
269811969 


Description 


Plot a histogram 

Plot a line graph or scatter plot 

Plot a surface chart 

Plot a Venn diagram 

Plot a pie chart 

Set translated axis line or datum line 
Set translated axis line or datum line 
Select x-axis 

Select y-axis 

Reset processing state to state 1 
Annotate chart 

Specific control of axis drawing 
Control pie chart slices 


Symbol Sets 


Symbol sets produced on the System/370 computer by the licensed programs 


GDDM Base Image Symbol! Editor (mode-2 image characters) and GDDM-PGF 


Vector Symbol Editor (mode-3 vector characters) are fully compatible with the 


AS/400 system, as are symbol sets supplied with System/370 GDDM. 


To use System/370 symbol sets with OS/400 Graphics, you must transport the 


source data from the System/370 computer to the AS/400 system, and then 
execute the CRTGSS (Create graphics symbol set) CL command to convert the 
symbol set source data into an AS/400 *“GSS object type. 


For more information on creating graphics symbol sets, refer to the GDDM 
Programming book. 
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GDF Order Descriptions 


Appendix B. 


GDF Order Descriptions 


Graphics data format (GDF) orders are like graphics CALL statements because 
they can be used to define pictures. Normally, they are generated from calls to 
GDDM routines, and are used internally by GDDM. One or more GDF orders may 
be saved using the GSGET call, and included among other GDF orders using the 
GSPUT call. 


The information in this appendix will help you to interpret GDF orders created by 
OS/400 Graphics or created by GDDM on the System/370 computer. 


Coordinates an 


© Copyright IBM Corp. 1994 


d Aspect Ratio in Comment Order 


When GDDM creates GDF orders, it prefaces them with a comment order that 
gives the window coordinate system, (and therefore the aspect ratio) on which it is 
to be built. For accuracy, the window coordinates are set to the largest possible 
values. Thus the largest of the window coordinate values will be in the region of 
32,000. When a picture is produced in GDF, then read back into GDDM using 
default (0 through 100) or similar window coordinates, the result is often that all 
plotted points are outside the window. 


To reshow a GDF picture, the window coordinates must be reset to the values in 
the comment order. The GDF picture can be reshown at any size by varying the 
size of the viewport in which it is presented. To preserve the aspect ratio of the 
picture, a GSPS call is required that is based on the coordinate values in the GDF 
comment. 


The comment order containing coordinate information has the format shown in 
Figure B-1. 
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GDF Order Descriptions 


Figure B-1. GDF Initial Comment Order Format 

Field 

Length | Field Type Content | Meaning 

1 Character X'01' Comment order code 

1 Binary integer LEN Length of following data 

2 Binary integer | TYP Data type of following fields as follows: 

e 1: Following fields are 1-byte (not 
supported on the AS/400 system) 

e 2: Following fields are 2-byte (the default 
on the AS/400 system) 

e 3: Following fields are 4-byte (not 
supported on the AS/400 system) 

e 4: Following fields are real (System/370 
floating point; not supported on the AS/400 
system) 

2 Binary integer | XLO Lowest x value 
2 Binary integer | XHI Highest x value 
2 Binary integer | YLO Lowest y value 
2 Binary integer | YHI Highest y value 


To recreate the aspect ratio and window of the original picture, the 2-byte binary 
integers in the initial comment order must first be converted to floating point 
numbers and then can be used as follows: 


CALL GSWIN(XLOFLOAT, XHIFLOAT, YLOFLOAT, YHIFLOAT) 


WIDTH 


= XHIFLOAT — XLOFLOAT 


HEIGHT = YHIFLOAT — YLOFLOAT 
IF (WIDTH > HEIGHT) THEN 
CALL GSPS(1.0,HEIGHT/WIDTH) 


ELSE 


CALL GSPS(WIDTH/HEIGHT, 1.0) 


Not all comment orders found in a GDF file contain the coordinate system 
information. For the format of comment orders used for other purposes, see the 
description of the comment order on page B-17. 


List of GDF Orders 


Figure B-2 shows the GDF orders in alphabetical order as they are described in 
this appendix. Figure B-3 shows the GDF orders in the order of their code values 
and should be of use for those who are interpreting the orders. 
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Figure B-2. Alphabetical Summary of GDF Orders 


Order Code Hex Value Page Number 
Arc C6 or 86 B-10 
Arc parameters 22 B-10 
Area end 60 B-11 
Area 68 B-11 
Character C3 Or 83 B-14 
Character mode 39 B-13 
Character set 38 B-14 
Character box 33 B-12 
Character angle 34 B-12 
Character shear 35 B-15 
Character direction 3A B-13 
Color OA B-15 
Color mix 0c B-16 
Color set extended 26 B-16 
Comment 01 B-17 
Fillet C5 or 85 B-17 
Graphics image begin D1 or 91 B-18 
Graphics image data 92 B-19 
Graphics image end 93 B-19 
Line C1 or 81 B-20 
Line relative E1 or Al B-21 
Line type 18 B-21 
Line width 19 B-22 
Marker C2 or 82 B-22 
Marker type 29 B-23 
Pattern 28 B-23 
Segment attribute 72 B-24 
Segment start 70 B-24 
Segment close 71 B-25 
Set tag 43 B-25 


Appendix B. GDF Order Descriptions 


B-3 


GDF Order Descriptions 


Figure B-3. Summary of GDF Orders in Order of Code Values 

Hex Value Order Code Page Number 
01 Comment B-17 
OA Color B-15 
0C Color mix B-16 
18 Line type B-21 
19 Line width B-22 
22 Arc parameters B-10 
26 Color set extended B-16 
28 Pattern B-23 
29 Marker type B-22 
33 Character box B-12 
34 Character angle B-12 
35 Character shear B-15 
38 Character set B-14 
39 Character mode B-13 
3A Character direction B-13 
43 Set tag B-25 
60 Area end B-11 
68 Area B-11 
70 Segment start B-24 
71 Segment close B-25 
72 Segment attribute B-24 
81 Line at current position B-20 
82 Marker at current position B-22 
83 Character at current position B-14 
85 Fillet at current position B-17 
86 Arc at current position B-10 
91 Graphics image begin B-18 
92 Graphics image data B-19 
93 Graphics image end B-19 
Al Line relative, current position B-21 
C1 Line B-20 
C2 Marker B-22 
C3 Character B-14 
C5 Fillet B-17 
C6 Arc B-10 
D1 Graphics image begin B-18 
E1 Line relative B-21 
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The following table shows which GDF orders are generated with the corresponding 


device: 


Figure B-4. GDF Orders Generated by Device 


Order 


Graphics 
Work Station 


L79A3 
Token 


scs IPDS 
Plotter | Printer | Printer 


01—Comment order 


X 


X X X 


0C-—Color mix 


18—Line type 


19-Line width 


X 
X 
xX 


X X X 
X X X 
X X X 


22-Arc parameters 


26—Color, set extended 


x< 


x< 
x< 


28—Pattern 


33—Character box 


34—Character angle 


35-—Character shear 


38—Character set 


39-Character mode 


3A-Character direction 


43-Set tag 


60-Area end 
68—Area 


70—Segment start 


71-Segment end 


x | K | KL XK | KK] KL KL KX | OK | OK | KY] Cx 


72-Segment attribute 


81-Line at current position 


83-Character at current position 


<x | K | Kx | KL KY] xX | xX II 


<| «| KK |< 


86-Arc at current position 


91-Graphics image begin 


92-Graphics data 


93-Graphics image end 
C1-Line 


x | K | K | XK | OK | OK | KL KY] KL OK | KL KK | KY] KL OK | OK | KK | KY] KY] KX | XK | K | CX 


<x |x| <x |< 
< |< | <x |< 
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The following table shows the GDF orders that are accepted by AS/400 GDDM but 
not generated. The table also shows whether AS/400 GDDM performs processing 
when the order is accepted or whether the order is simply ignored. 


These orders are not described in this appendix. For information on these orders, 
refer to the documentation for the product that was used to generate the GDF 
stream that contains the orders. 


Figure B-5 (Page 1 of 2). GDF Orders Accepted but Not Generated 


Order Processed | Ignored 


02-Process specific control Xx 


03—Push and set character box 


04—Segment characteristics 


08—Pattern set 


< |< | &K | X< 


09-Push and set pattern 


OA-—Color X 


0D-Background mix xX 


11-Fractional line width x 


21-Current position X 


23-Push and set pick (tag) identifier 


x< 


24—Model transform 


29—Marker type Xx 


37—Marker cell 


3B—Marker precision 


3C-—Marker set 
3E-—Segment end prolog 


3F—Pop attribute 


41—Marker scale 


4A-—Push and set color 


4C—Push and set mix 


51-Push and set fractional line width 


53—Segment position 


58—Push and set line type 


59-Push and set line width 


62—Push and set arc parameters 


64—Push and set model transform 


66—Push and set extended color 


69-Push and set marker type 


73-Segment attribute modify 


74—Push and set character angle 


75—Push and set character shear 


Kx | K | K | KK | OK] KL KY] OK | OK | OK | KL KY] OK | KL XK | KK | KY] xX 


78—Push and set character set 
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Figure B-5 (Page 2 of 2). GDF Orders Accepted but Not Generated 


Order Processed | Ignored 


79—Push and set character mode x 


7A—Push and set character direction x 


82—Marker at current position 


85-Fillet at current position 


87-Full arc at current position 


Ai—Relative line at current position 
C2-—Marker 

C3-Character 

C5-Fillet 

C6-Arc 

C7-Full arc 


D1-—Graphics image 


x | KL K | XK | OK] KK LK LK LK] XK II 


E1-Relative line 


Orders Supported by the AS/400 System 


All currently defined GDF orders are accepted by the AS/400 system, but not all 
are supported. In particular, those orders dealing with segment attributes are not 
supported. 


Orders that are not supported by the AS/400 system or orders that contain 
parameter values that are not supported are ignored. 


General Structure 


A GDF file consists of a sequence of orders. 


Each order is identified by a 1-byte order code and contains one or more bytes of 
operand data. 


Order Formats 


Normal Format 


The order is represented in one of two formats depending on the length of the 
operand data. 


The first format applies to orders with up to 255 bytes of operand data. The 
second applies only to orders that have a single byte of operand data. 


In the normal format, there is a 1-byte order code and a 1-byte length field, 
followed by /ength bytes of operand data: 


order code length (can be zero) operand data 
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Short Format 


In the short format, the length field is not present and there is a single byte of data: 


order code operand data 


In all short format orders, the first hexadecimal digit must be less than 8, and the 
second must be 8 or greater. 


Padding 


Orders can be followed by padding bytes (X'00') to align the next order on a 
convenient boundary. 


Coordinate Data 


Many of the orders contain coordinate data or coordinate-related data. On the 
AS/400 system, these coordinates are always represented as 2-byte binary 
integers; that is, they are normal 15-bit numbers with sign. If negative, they are in 
twos-complement notation. 


The type and length of coordinates must be specified on the GSPUT call, and for 
the AS/400 system must always be specified as 2-byte binary integers. 


Primitives 


The following graphics primitives can be represented: 
e Line (relative or absolute) 
e Marker 
¢ Character string 
¢ Curved fillet 
e Arc (circular, elliptical, or full) 
¢ Graphics image 


The orders correspond closely with many of the API functions. 


Current Position 


The GDF order formats given below contain all relevant coordinates. However, for 
brevity the start position of the graphic primitive can be omitted. If it is omitted, 
current position is used in its place. 


Current position is set by each of the orders. It is set to the end point of a line or 
arc and, except in the case of character strings, the rule is the same as for the 
corresponding API function. 


The presence or absence of the initial coordinate is indicated by bit 1 of the order 
code. If it is 0, the first coordinate in the order is omitted, and the current position 
is assumed in its place. 
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Coordinate Lengths 
In the following primitives, coordinates are assumed to be pairs of 2-byte binary 
integers. This is the only type accepted by the AS/400 system. Coordinate and 
coordinate-related fields are marked by *. 


Attributes 


As with the equivalent CALL statements, attribute setting orders change the current 
values of the attributes. An attribute setting applies to all subsequent primitives (to 
which it is relevant) until a new setting is made. 


Attribute setting orders appearing in a GDF string argument to GSPUT affect the 
current attribute settings after the call. The effects are not purely local to primitives 
within the string, but may affect subsequent primitives. 


The details of the effects of the order are not given in full. For more explanation, 
see the corresponding CALL statement description. 


Format of Examples 
The examples are given in hexadecimal with 2-byte binary integer coordinates. 
Blanks in the hexadecimal strings are to aid readability. They have no other 
significance. 


Orders 


The following section describes GDF orders that are generated or accepted and 
processed by the AS/400 system. Orders that are accepted and ignored are not 
described here. 
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Arc Order 
Format: 
Field 
Length | Content Meaning 
1 X'C6' or X'86' Arc order code 
1 LEN Length of following data 
2* X0 x coordinate of start of arc 
fag YO y coordinate of start of arc 
2* x1 X coordinate of intermediate point 
2* Y1 y coordinate of intermediate point 
2* X2 x coordinate of end of arc 
2* Y2 y coordinate of end of arc 


This order constructs an arc starting at (X0,Y0) and passing through (X1,Y1) and 
ending at point (X2,Y2). 


The intermediate point (X1,Y1) should, for greatest accuracy, lie midway along the 
arc. (If it coincides with either end point, the arc becomes undefined.) The initial 
point and the final point must not coincide. 


The arc may be part of a circle or part of the ellipse defined by the previous set arc 
parameters order. 


The initial coordinate pair (X0,Y0) may be omitted. The current position is then 
used as the starting point of the arc and the order code becomes X'86'. 


The current position is set to point (X2,Y2). 


Set Arc Parameters Order 


Format: 
Field 
Length | Content Meaning 
1 X'22' Set Arc Parameters order code 
1 LEN Length of following data 
2* P X coordinate of major axis end 
2* Q y coordinate of minor axis end 
2* R X coordinate of major axis end 
2* Ss y coordinate of minor axis end 


The order determines the shape of subsequent arcs. The full parameters give a 
transformation that maps the unit circle to the required ellipse: 


x' = Px + Ry 
y' = Sx + Qy 


A circle results if P=Q and R=S=0. 

If P equals a and Q equals b, an ellipse results. The axis parallel to the x-axis has 
a length proportional to 'a'; the axis parallel to the y-axis has a length proportional 
to 'b’. 
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If R and S are nonzero, the ellipse is tilted. In general, for an ellipse with major 
and minor axes proportional to 'a' and 'b’, tilted at angle ‘theta’ to the x-axis: 


P = a*cos(theta) 
Q = b*cos (theta) 
R = -b*sin(theta) 
S = axsin(theta) 


Area End Order 


The Area End order has the same meaning as the Area order with the area-end bit 
set. GDDM accepts both the Area order and the Area End order, but generates 


only the Area End order. 


Format: 
Field 
Length | Content Meaning 
1 X'60' Area end order code 
1 LEN Length of following data 
n X'00' Reserved (must be all X'00') 


Area Order 


The Area order corresponds approximately to the GSAREA and GSENDA 
functions. See “GSAREA-Start a Shaded Area” on page 2-47 and “GSENDA-—End 
a Shaded Area” on page 2-76 for more details. 


Format: 
Field 
Length | Content Meaning 
1 X'68' Area order code 
1 FLAGS Bit 0: 
¢ On if this marks the start of an area 
¢ Off if this order marks the end of an area (not generated on 
the AS/400 system) 
Bit 1: 
¢ On if the boundary lines are to be drawn 
Examples: 
8 80 


C1 14 0000 0000 0005 0000 0005 0005 0000 0005 0000 9000 


60 00 


Draws a rectangular area 5 units square. Boundary lines are not drawn. 


68 CO 


C1 14 0000 0000 0005 0000 0005 0005 0000 0005 0000 9000 


60 00 


Draws the same area, but includes boundary lines. 
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Character Angle Order 


The Character Angle order corresponds to the GSCA function. It controls the angle 
of subsequent character strings. 


Format: 
Field 
Length | Content Meaning 
1 X'34!' Character angle order code 
1 LEN Length of following data 
2* AX x coordinate of a point that defines the angle of the text 
2* AY y coordinate of the point 


AX and AY specify a relative vector that defines the angle of the baseline of the 
string. If the coordinate (X,Y) is on the baseline, (X + AX, Y + AY) is also on the 
baseline. (See “GSCA-Set Current Character Angle” on page 2-50.) 


Character Box Order 


The Character Box order corresponds to the GSCB function. It controls the size of 
subsequent characters. Refer to GSCB for more details. 


Format: 

Field 

Length | Content Meaning 

1 X'33! Character box order code 

1 LEN Length of following data 

2* CHARWIDTH Integer width of character box 

2* CHARHEIGHT Integer height of character box 

2* FRACTWIDTH Fractional portion of character box width, specified as multiples of 
1/65536 for 2-byte format. 

2* FRACTDEPTH Fractional portion of character box depth, specified as multiples 
of 1/65536 for 2-byte format. 


If either the fractional width or depth is to be specified, both must be specified. The 
integer and fractional widths (depths) together form a character width (depth) that 
defines the character box required. 


The order specifies the size of characters in following character strings. (See 
“GSCB-Set Current Character Box Size” on page 2-52.) 
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Character Direction Order 


The Character Direction order corresponds to the GSCD function. See “GSCD-Set 
Current Character Direction” on page 2-55 for further details. 


Format: 
Field 
Length | Content Meaning 
1 X'3A' Character direction order code. 
1 DIRECTION Value for character direction. These are interpreted as follows: 


X'00': Default 
X'01': Left to right 
X'02': Top to bottom 
X'03': Right to left 
X'04': Bottom to top 


The Character Direction order gives the placement of each character relative to the 
previous one, either along or perpendicular to the baseline. 


Text Attributes 


Character Mode Order 


The Character Mode order corresponds to the GSCM function. Refer to 
“GSCM-Set Current Character Mode” on page 2-66 for more details. 


Format: 
Field 
Length | Content Meaning 
1 X'39' Character mode order code. 
1 MODE Value for character mode attribute. These are interpreted as 
follows: 
X'00': Default 


X'01': String precision (not valid on the AS/400 system; will 
leave the character mode unchanged) 


X'02': Character precision (image) 
X'03': Stroke precision (vector) 
Other: Undefined 
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Character Order 


The Character order corresponds to the GSCHAR and GSCHAP functions. 


Format: 
Field 
Length | Content Meaning 
1 X'C3' or X'83' Character order code 
1 LEN Length of following data 
2* X0 X coordinate at which character string is to be placed 
2* YO y coordinate of character string 
Vv STRING EBCDIC character code of each character in the string; all 
characters above and including X'40' are valid 


The character string is placed at the indicated coordinate. The attributes of the 
string (for example, mode, size, angle) are taken from the current values. 


If the character string has an odd length, the length field in the order will contain an 
odd number. The order must be padded with padding characters to an even 
number of bytes. 


The position (X0,Y0) may be omitted, in which case the order code becomes X'83' 
and the string is placed at the current position. 


Current position is not changed. (This is different from GSCHAR.) 


Examples: 


C3 08 0002 0003 C1C2C3C4 


Draws the character string 'ABCD' at coordinate (2,3). 
83 03 C5C6C7 


Draws the character string 'EFG' at the current position. 


Character Set Order 


The Character Set order corresponds to the GSCS function. 


Format: 
Field 
Length | Content Meaning 
1 X'38' Character set order code. 
1 LCID Local identifier for the character set: 


X'00': Default 
X'41' through X'DF': User-defined set 
Other: Undefined 
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The Character Shear order corresponds to the GSCH function. It controls the 
shear of subsequent characters. 


Format: 
Field 
Length | Content Meaning 
1 X'35! Character shear order code. 
1 LEN Length of following data. 
2* HX HX and HY specify a relative vector that defines the angle at 
which characters are to be sheared. 
2* HY y increment; see above. 


HX and HY specify a vector that defines the angle of the upright strokes of a 
character relative to the baseline. If the lower-left corner of a character is placed at 
(0,0) and the character baseline lies along the x-axis, the line from (0,0) to (HX,HY) 
gives the direction of upright strokes. (See “GSCH-—Set Current Character Shear” 
on page 2-57.) 


The Color order corresponds approximately to the GSCOL function. Refer to 
“GSCOL-Set Current Color” on page 2-68 for more details. 


Format: 
Field 
Length | Content Meaning 
1 X'0A' Color order code 
1 COLOR Value for color attribute 


The value is an index to a color table that has the following 
default values: 


X'00': Default 

X'01': Blue 

X'02': Red 

X'03': Pink 

X'04': Green 

X'05': Turquoise 

X'06': Yellow 

X'07': Neutral (white on displays, black on printers and 
plotters) 

X'08': Background (black on displays, white on printers and 
plotters) 

Other: Undefined 


All subsequent primitives have the color given until this is reset. 
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Color Set Extended Order 


The existing GSCOL call and the 1-byte Color order are mapped to the 2-byte 
Color Set Extended order as follows (the existing Color order is not generated). 


Format: 
Field 
Length | Content Meaning 
1 X'26' Color set extended order code 
2 COLOR Value for color attribute 


The value is an index to a color table that has the following 
values: 


X'0000': Green 

X'FFOO': Green 

X'FFO1': Blue 

X'FFO2': Red 

X'FFO3': Pink 

X'FF04': Green 

X'FFO5': Turquoise 

X'FFO6': Yellow 

X'FFO7': Neutral 

X'FFO8': Background (black on displays, white on printers 
and plotters) 

X'0009' through X'7FFF' The same color definitions as 
X'FFO1' through X'FFO8' are repeated. 


All subsequent primitives have the color given until this is reset. 


Color Mix Order 


The Color Mix order corresponds to the GSMIX function. Refer to “GSMIX—Set 
Current Color-Mixing Mode” on page 2-98 for more details. 


Format: 
Field 
Length Content Meaning 
1 X'0C' Mix order code. 
1 MODE Value for mix mode attribute. Mix mode controls how an 


inserted primitive affects the existing picture. In all modes, 
generated 0 bits leave the underlying features untouched; new 
1 bits become whatever the current color is if that bit was 
previously of background color. The effect of a new 1 bit over 
an existing 1 bit depends upon the particular mode: either the 
old color (underpaint), or the new color (overpaint), or a mixture 
(mix or exclusive OR) will result. 


X'00': Default 
X'01': Mix (OR) 
X'02': Overpaint 
X'03': Underpaint 
X'04': Exclusive (OR) 
Other: Undefined 
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Comment Order 


Fillet Order 


Format: 
Field 
Length | Content Meaning 
1 X'01' Comment order code. 
1 LEN Length of following data. 
V ANYDATA The data is ignored. 


The Comment order can be used to embed user data in a GDF file. The contents 
are ignored by GDDM. 


The first order output by GSGET is a Comment order whose data field gives the 


coordinate range used in the file and the coordinate length. Comment orders are 
occasionally generated by GDDM to pad GDF sirings to a known length. 


The Fillet order corresponds approximately to the GSPFLT function. 


Format: 
Field 
Length | Content Meaning 
1 X'C5' or X'85! Fillet order code 
1 LEN Length of following data 
2* X0 x coordinate of line start 
2° YO y coordinate of line start 
2* x1 x coordinate of first line end 
2* Y1 y coordinate of first line end 
2* x2 x coordinate of second line end 
2* Y2 y coordinate of second line end 


The order shown generates a single fillet. Further coordinate pairs may be added 
to form a polyfillet. The points are joined in order by imaginary straight lines. A 
curve is then fitted to the lines as follows. The curve is tangential to the first line at 
its starting point and to the last line at its end point. If there are intermediate lines, 
the curve is tangential to these lines at their center points. 


In the special case when only two points are supplied, a straight line results. 


The initial coordinate pair (X0,YO) may be omitted. Current position is then used as 
the starting point of the arc, and the order code becomes X'85'. 


Current position is set to the last point specified. 


Appendix B. GDF Order Descriptions B-17 


GDF Order Descriptions 


Examples: 
C5 08 0002 0003 0004 0006 
Draws a line from coordinate (2,3) to coordinate (4,6). 
C5 OC 0000 8000 0004 8000 0004 0004 
Draws a curve, beginning at coordinate (0,0) and tangential to the line from (0,0) to 


(4,0). Initially the curve is horizontal. The curve then takes an approximately 
circular path to meet the line from (4,0) to (4,4) at (4,4). 


Graphics Image Order—Begin 
The Begin Graphics Image order, together with the Graphics Image Data and End 
Graphics Image orders, corresponds approximately to the GSIMG and GSIMGS 
functions. Refer to “GSIMG—Draw a Graphics Image” on page 2-86 and 
“GSIMGS—Draw Scaled Graphics Image” on page 2-89 for more details. 


Format: 
Field 
Length | Content Meaning 
1 X'D1' or Begin Graphics Image order code 
X'91! Begin Graphics Image (at current position) order code 
1 LEN Length of following data 
2* X0 The x position at which the graphics image is to be placed 
2* YO The y position at which the graphics image is to be placed 
2 FORMAT The format of the graphics image data; this field must have the 
value 0 
2 WIDTH The width of the graphics image in pixels 
2 DEPTH The depth of the graphics image in pixels 
2* IMAGEWIDTH The desired width of the graphics image in coordinate units 
2* IMAGEDEPTH The desired depth of the graphics image in coordinate units 


A graphics image consists of a rectangular array of pixels. 


It is represented by a sequence of orders. The first is a Begin Graphics Image 
order and the last is an End Graphics Image order (see “Graphics Image 
Order—End” on page B-19). Between these delimiters, a number of Graphics 
Image Data orders may occur, giving the array of pixels in the graphics image. 


The size of the pixel array and its representation are given by the Begin Graphics 
Image order. The fields IMAGEWIDTH and IMAGEDEPTH are optional and may 
be either both specified, or both omitted. When specified, the graphics image will 
be scaled to fill the area identified by the fields, using the rules defined in the 
GSIMGS call. When omitted, each pixel is represented by one bit in the pixel 
array. 


The position of the graphics image (top left corner for format 0) is optional. 
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Format: 
Field 
Length | Content Meaning 
1 X'92! Graphics Image Data order code 
1 LEN Length of following data 
V PIXELDATA The pixels of the graphics image 


For graphics image FORMAT 0, each Graphics Image Data order contains the 


pixels for one row of the pixel array. Thus for a graphics image with a DEPTH of N 
there will be N Graphics Image Data orders between the Begin and End Graphics 
Image orders. Each Graphics Image Data order contains data for WIDTH pixels. 
Each pixel is represented by a single bit. If the bit is one, the pixel is on; if the bit 


is zero, the pixel is off. 


Example: 
91 06 0000 0009 0004 


92 02 FF80 
92 02 8080 
92 02 8080 
92 02 FF80 
93 02 0000 


Draws a graphics image whose size is nine display points wide by four deep at 
current position. The graphics image consists of a small square of on pixels (which 
will appear in the current color) surrounding an off center. 


Graphics Image Order—End 


Format: 
Field 
Length | Content Meaning 
1 X'93' End Graphics Image order code 
1 LEN Length of following data 
2 RESERVED 


This order ends the construction of a graphics image. 
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Line Order 
The Line order corresponds approximately to the GSLINE and GSPLNE functions. 


Format: 
Field 
Length | Content Meaning 
1 X'C1' or X'81! Line order code 
1 LEN Length of following data 
2* X0 x coordinate of line start 
2* YO y coordinate of line start 
2* x1 x coordinate of first line end 
2* Y1 y coordinate of first line end 


A line is drawn from the first coordinate given (X0,Y0) to the second (X1,Y1). 


The order shown is for a single line, but in general any number of coordinates can 
be present. Consecutive coordinates in the order will be joined by straight lines. 
The data length must be an even multiple of the coordinate length. 


The initial coordinate pair (X0,YO) may be omitted. Current position is then used as 
the starting point of the first line, and the order code becomes X'81'. 


Current position is set to the last point specified. 


Note that a line order with only an initial position is permitted. This serves only to 

move current position. 

Examples 
C1 08 0002 0003 0004 0006 

Draws a line from coordinate (2,3) to coordinate (4,6). 
C1 OC 0002 0003 0004 0006 0009 0009 

Draws a line from coordinate (2,3) to coordinate (4,6) and a line from (4,6) to (9,9). 
C1 04 0002 0003 

Draws no lines. However, current position is changed to the last coordinate (2,3). 
81 04 0004 0006 

Draws a line from current position to point (4,6). Thus, the pair of orders: 


C1 04 0002 0003 
81 04 0004 0006 


has the same effect as the first: 
C1 08 0002 0003 0004 0006 
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Line Relative Order 
The Line Relative order defines one or more straight lines. 


Format: 
Field 
Length | Content Meaning 
1 X'E1' or Line Relative order code 
X'A1' Line Relative (at current position) order code 
1 LEN Length of following data 
2* X0 x coordinate of line start 
2* YO y coordinate of line start 
1 x1 x coordinate of first line end 
1 Y1 y coordinate of first line end 


The data length must be an even multiple of the coordinate length. 


X1 and Y1 are relative to the start position (if X'E1') or current position (if X'A1'). 
They are 1-byte, signed values that are added/subtracted from the 1-byte x and y 
positions to determine the line end. 


Line Type Order 


The Line Type order corresponds to the GSLT function. 


Format: 
Field 
Length | Content Meaning 
1 X'18! Line Type order code. 
1 LINETYPE Value for line type attribute. The value is an index into a notional 
line-type table as follows: 
X'00': Default 


X'01': Dotted line 

X'02': Short dashed line 
X'03': Dash-dot line 
X'04': Double dotted line 
X'05': Long dashed line 
X'06': Dash-double-dot line 
X'07': Solid line 

X'08': Invisible line 

Other: Undefined 
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Line Width Order 
The Line Width order corresponds to the GSLW function. 


Format: 
Field 
Length | Content Meaning 
1 X'19' Line Width order code. 
1 LINEWIDTH Value for line width attribute. The value is an index into a 
notional table of line-widths as follows: 
X'00': Default 


X'01': Normal line 
X'02': Thick line 
Other: Undefined 


Marker Order 
The Marker order corresponds approximately to the GSMRKS function. 


Format: 
Field 
Length | Content Meaning 
1 X'C2' or X'82' Marker order code 
1 LEN Length of following data 
2* X0 x coordinate of marker 
2* YO y coordinate of marker 


The order is shown for a single marker. Further coordinate pairs may be added. 
The current marker is placed at each point specified. 


The first (or only) coordinate pair may be omitted. The order code then becomes 
X'82', and a marker is placed at current position in addition to any points 
specified. 


Current position is set to the last coordinate specified. If no coordinate has been 
specified, current position is unchanged. 
Examples: 
C2 04 0002 0003 
Draws the current marker at coordinate (2,3). 
C2 OC 0002 0003 0004 0006 0009 0009 
Draws markers at (2,3) (4,6) and (9,9). 
82 00 


Draws the current marker at current position. 
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GDF Order Descriptions 


The Marker Type order corresponds to the GSMS function. 


Format: 
Field 
Length | Content Meaning 
1 X'29' Marker Type order code. 
1 N Marker number. The attribute determines which symbol is 


X'00' 


Other: 


Pattern Order 


The Pattern order corresponds to the 


displayed by the marker primitive. The interpretation of the 
values is as follows: 


: Default 
X'01': 
X'02': 
X'03': 
X'04': 
X'05': 
X'06': 
X'07': 
X'08': 
X'09': 
X'10': 
X'41'-X'EF': User defined 


Cross 

Plus 

Diamond 
Square 
6-point star 
8-point star 
Filled diamond 
Filled square 
Dot 

Small circle 


Undefined 


GSPAT function. 


Format: 
Field 
Length | Content Meaning 
1 X'28' Pattern order code. 
1 PATTERN Value for pattern attribute. This attribute determines which 


X'00' 


X'09' 
X'0A' 
X'OB' 
X'0C' 
X'0D' 
X'OE' 
X'OF' 
X'10' 
Other: 


pattern is to be used to shade the interior of subsequent areas. 
The interpretation of the values is as follows: 


: Default 
X'01' through X'08': Density 1 to density 8 (decreasing) 
: Vertical lines 


: Horizontal lines 
: Diagonal lines 1 
: Diagonal lines 2 
: Diagonal lines 1 
: Diagonal lines 2 
: No shading 


bottom-left to top-right) 
bottom-left to top-right) 
) 
) 


top-left to bottom-right 
top-left to bottom-right 


= 


: Solid shading 


Undefined 
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Segment Attribute Order 


The Segment Attribute order sets the attributes that will be assigned to 
subsequently generated segments. 


Format: 


Field 
Length 


Content 


Meaning 


{ 
{ 


X'72! 
LEN 


Segment Attribute order code. 


Length of following data. 


{ 


ATTRIBUTE 


The attributes that can be set for subsequent segments are: 


X'01': Detectability 

X'02': Visibility 

X'03': Highlighting 

X'04': Transformability 
X'05': Stored/nonstored state 


Segment Start Order 


Format: 


VALUE 


The values that can be assigned to the specified attribute are: 


X'00': Not detectable, invisible, not highlighted, or stored 
X'01': Detectable, visible, highlighted, nontransformable, or 
nonstored 

X'02': Transformable 


Field 
Length 


Content 


Meaning 


{ 


X'70! 


Segment Start order code 


{ 


LEN 


Length of following data 


4 


SEGMENT ID 
FLAGS 


The identifier for to the following segment, or 0 if unnamed 
Bit 
0 0 = visible 
1 = invisible 
1 Reserved, must be 1 
2 0 = nondetectable 
1 = detectable 
3 Reserved, must be 1 
4 0 = no highlighting 
1 = highlighting 
5 Reserved, must be 1 
6-10 Reserved, must be 0 
11 0 = no prolog 
1 = prolog 
12 0 = nontransformable 
1 = transformable 
13-15 Reserved, must be 0 


LEN 


Length of segment 


X'0000' 


Reserved, must be 0 


GDDM returns the length of a fixed-point GDF segment in the Segment Start order 
retrieved using GSGET. The length of the segment is ignored on GSPUT; 
segments must be closed by an explicit Segment Close order. 
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GDF Order Descriptions 
The order corresponds to the GSSEG function. Refer to “GSSEG-Create a 
Segment” on page 2-144 for more details. 


Segment Close Order 
The Segment Close order corresponds to the GSSCLS function. 


Format: 
Field 
Length | Content Meaning 
1 X'71! Segment Close order code 
1 LEN 0, no data 


Set Tag Order 


The Set Tag order is used to set the current value of the tag. All output primitives 
that follow this order and precede the next Set Tag order are given the tag value 
specified. 


This order is ignored on the AS/400 system. 


Format: 
Field 
Length | Content Meaning 
1 X'43' Set Tag order code 
1 4 Length of following data 
4 TAG Tag value 
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Attributes 


Appendix C. Colors, Line-Types, Markers, and Shading 


Patterns 
The colors, line types, markers, and shading patterns that are given to distinguish 
one data group from another are taken from tables whose values are used in 
rotation. Each data group can have a different color, line-type, marker, and 
shading pattern. Tables with default values are supplied. You can control the 
attributes of the data by resetting the values in the tables. 
Color Numbers 
Valid color numbers and their meanings are: 
5224/5, 
3812, 
3816, 
4028, 
Color GDDM Display 618x 7372 7371 4214, 
Attribute Color Default Plotter Plotter Plotter 4234-2 4224 
Value Definition Color Pen No. Pen No. Pen No. Printer Printer 
-2 White White No pen No pen No pen Background Background 
-1 Black Black 7 6 1 Black Black 
0 Default Green 8 6 2 Black Black 
1 Blue Blue 1 1 1 Black Blue 
2 Red Red 2 2 2 Black Red 
3 Magenta Pink 3 3 1 Black Magenta 
4 Green Green 4 4 2 Black Green 
5 Turquoise Turquoise 5 5 1 Black Cyan 
6 Yellow Yellow 6 6 2 Black Yellow 
7 Neutral White 7 6 1 Black Black 
8 Background Background No pen No pen No pen Background Background 
9 Dark blue Blue 1 1 1 Black Blue 
10 Orange Red 2 2 2 Black Red 
11 Purple Pink 3 3 1 Black Magenta 
12 Dark green Green 4 4 2 Black Green 
13 Dark turquoise Turquoise 5 5 1 Black Cyan 
14 Mustard Yellow 6 6 2 Black Yellow 
15 Gray White 7 6 1 Black Black 
16 Brown Green 8 6 2 Black Brown 
17 - Beginning with 17, the color definitions for values 9 through 16 are repeated up to 32,767. 
32,767 
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Attributes 


Line-Type Numbers 
Valid line-type numbers and their meanings are: 


Line | Graphics work stations SCS Printers and Plotters IPDS Printers 
type 
attrib. Px, one es 
value Description Appearance Description Appearance Description Appearance 
0 Solid Solid Solid 
(default) (default) (default) 
1 Dotted. «> “é dissewejelsicies's Dotted = nd acecceceece Dotted 2 oie ieee’ 
2 Short-dashed ______ Short-dashed ______ Short-dashed __ 
3 Dash-dot) Dash-dot ; __ | Dash-dot = 
4 Double-dot ve ec ee we ee | LONg-dash _______ |: Double-dot ota eta 
short-dash 
5 Long-dashed Long-dashed ____| Long-dashed —— 
6 Dash-dot-dot | Long-dash _____si|«~iDash-dot-dot 
short-dash-dash 
7 Solid Solid Solid 
8 Invisible Invisible Invisible 


RV2F758-0 


Note: Line styles on an IBM personal computer must be configured to match 


these defaults. 


Marker Numbers 
Valid marker numbers and their meanings are: 


1 xX 6 
os 7 ¢ 
3.0 8 ff 
40 3 @ 
5 xX 10 O 

RSLF401-0 


On the AS/400 system, values 65-254 are also supported. Symbol sets defining 
markers can be loaded by an application program before the chart is constructed. 
(See “GSLSS—Load a Graphics Symbol Set from Auxiliary Storage” on page 2-92.) 
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Attributes 


Shading Pattern Numbers 
Valid pattern numbers and their meanings are: 


10 


11 


12 


13 


fechtmgay Bites mr rece Bem a Se Re mR aca om mcRees omy Be fa ena sero 14 


15 


16 


RV2F760-0 


For IPDS printers, and plotters, the area fill patterns are device dependent. 


Appendix C. Colors, Line-Types, Markers, and Shading Patterns C-3 


Attributes 


C-4 AS/400 GDDM Reference 


Double-Byte Character Set Support 


Appendix D. Double-Byte Character Set Support 


This appendix contains information that you need if you use GDDM double-byte 
characters. This includes the following topics: 


Double-byte character set (DBCS) fundamentals 
DBCS symbol-set handling 

Selecting a double-byte language 

DBCS character-string handling 

DBCS graphics-capable device support 

DBCS error handling 


For information on DBCS printer and spooling support, see the Printer Device 
Programming. 


DBCS Fundamentals 


Some languages, such as Chinese, Japanese, and Korean, have a writing scheme 
that uses many different characters that cannot be represented with single-byte 
codes. To create coded character sets for such languages, the system uses 
2-bytes to represent each character. Characters that are encoded in 2-byte code 
are called double-byte characters. 


You can use double-byte characters as well as single-byte characters in one 
application. For instance, you may want to store double-byte data and single-byte 
data in your database, create your display with double-byte text and fields, or print 
reports with double-byte characters. 


1-Byte Code 2-Byte Code 
(SBCS) (DBCS) 

A — XC’ A — X’42C1’ 

B —  X’C2’ Bo — X’42C2’ 

1 —— XF1’ 1 MM X’42F1’ 

2 — XF2’ 2 — X’42F2’ 
& —  x’4481’ 
3 =—— X’457D’ (Japanese ) 
7t} + —— x’8877’ ( Japanese ) 
= —— X'525F’ (Korean) 
it ——  x’4F99’ (Simplified Chinese ) 
i =  ’5B70’ (Traditional Chinese ) 


1-Byte Codes: 


2-Byte Codes: 


X’hhhh’ indicates that the code has the hexadecimal value, "hHhhh". 


256 characters 


256 X 256 characters 


HRSLS338-1 


Figure D-1. Single-Byte and Double-Byte Code Schemes 
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Double-Byte Character Set Support 


DBCS Code Scheme 


The IBM host code scheme has the following code-range characteristics: 


First byte 

hex 41 to hex FE 
Second byte 

hex 41 to hex FE 
Double-byte blank 

hex 4040 


In the following figure, using the first byte as the vertical axis and the second byte 
as the horizontal axis, 256 x 256 intersections or code points are expressed. The 
lower-right code area is designated as the valid double-byte code area and x is 
assigned to the double-byte blank. 


2nd byte —————» 


1st 0 4/4 F/F 
byte 0 0}1 E|F 

00 

40 x 

Aq 

D 

FE 

FF 

D: double-byte code area 

x: double-byte blank RSLH712-4 


Figure D-2. IBM-Host Code Scheme 


By assigning hex 41 to hex FE as DBCS character codes in the first and second 
bytes, the codes can be grouped in wards with 192 code points in each ward. For 
example, the code group with the first byte starting with hex 42 is called ward 42. 
Ward 42 has the same alphanumeric characters as those in a corresponding 
single-byte EBCDIC code page, but with double-byte codes. For example, the 
character A is represented in single-byte EBCDIC code as hex C1 and in IBM-host 
code as hex 42C1. 


Shift-Control Characters 


When the IBM host code scheme is used, the system uses shift-control characters 
to identify the beginning and end of a string of double-byte characters. The 
shift-out (SO) character, hex OE, indicates the beginning of a double-byte character 
string. The shift-in (SI) character, hex OF, indicates the end of a double-byte 
character string. 
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1-Byte Data 1-Byte Data 


2-Byte Data 

1-Byte Data SO | 2-Byte Data SI | 1-Byte Data 
Control 
Character 


RSLH713-1 


Each shift-control character occupies the same amount of space as one 
alphanumeric character. By contrast, double-byte characters occupy the same 
amount of space as two alphanumeric characters. 


Selecting a Double-Byte Language 
AS/400 GDDM supports the following double-byte character sets: 


IBM Japanese Character Set 

IBM Korean Character Set 

IBM Simplified Chinese Character Set 
IBM Traditional Chinese Character Set 


You select a DBCS language by calling the GSLSS routine and specifying one of 
the following values for the SYMBOL-SET-NAME parameter: 


ADMXK* Japanese 

ADMXH* Korean 

ADMXC* Simplified Chinese 
ADMXT* Traditional Chinese 


When you specify a SYMBOL-SET-TYPE parameter value of 5 and a 
SYMBOL-SET-ID parameter value of 0, the language specified on the 
SYMBOL-SET-NAME parameter is the current DBCS language. 


If no DBCS language is selected and a character string containing shift-out or 
shift-in characters is processed by GDDM, a diagnostic error message is signaled 
and the character string is displayed as blanks. 


If no DBCS language is selected and a nonbracketed DBCS character string is 
processed by GDDM, the string is displayed as single-byte character data. 


DBCS Symbol-Set Handling 


For DBCS language support, the symbol sets are standard SBCS sets (each set 
provides 192 characters ('40'X - 'FE'X)). A symbol set corresponds to each ward 
supported in each language supported, as described in the following table: 
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Figure D-3. Language Support 


Language Wards Content 
Japanese 41 - 44 Non-Kanji characters 

45 - 55 Basic Kanji characters 

56 - 68 Extended Kanji characters 

69 - 7F User-defined characters (Symbol sets not provided) 
Korean 41 - 46 Non-Hangeul/Hanja characters 

50 - 6C Hanja characters 

84 - D3 Hangeul characters 


D4 - DD User-defined characters (Symbol sets not provided) 


Simplified Chinese 41 - 47 Non-Chinese characters 

48 - 6F Chinese characters (Level 1 and Level 2) 

76 - 7F User-defined characters (Symbol sets not provided) 
Traditional Chinese 41 - 46 Non-Chinese characters 

4C - 68 Primary Chinese characters 

69 - 91 Secondary Chinese characters 


DO - DD User-defined characters (Symbol sets not provided) 


User-defined DBCS characters are supported for each language, but symbol sets 
are not provided. 


The naming convention for DBCS symbol sets is ADMxcp1p2. 


Figure D-4. Naming Convention for DBCS Symbol Sets 


X | for mode-2 (Image) or V for mode-3 (Vector) text 
c Language Supported 


K = Japanese 

H = Korean 

C = Simplified Chinese 
T = Traditional Chinese 


p1p2 Page (ward) 


Loading and Releasing DBCS Symbol Sets 


GDDM internally manages the loading and releasing of all DBCS symbol sets. 
When a double-byte character is processed, the ward is checked to determine if the 
ward is valid for the DBCS language currently selected. If the ward is not valid, the 
output is blank. If the ward is valid, the symbol set is loaded and normal character 
processing takes place. 


GDDM allows up to 8 DBCS symbol sets to be loaded at one time. If anew DBCS 
symbol set needs to be loaded, and the maximum has already been reached, then 
a currently loaded DBCS symbol set is released before the new symbol set is 
loaded. The symbol set to be released is determined by a least-recently-used 
algorithm. 
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In order for GDDM to manage the DBCS symbol sets, they must exist in the user's 
library list and must adhere to the naming conventions. Typically, these symbol 
sets are installed in the QGDDM library or a secondary language library. 


DBCS symbol sets can be managed directly by an application just as any other 
image or vector symbol set, but this is not recommended if the application is using 
DBCS character strings. GDDM manages the DBCS symbol sets when processing 
double-byte character strings and operations may be performed on the symbol sets 
(such as loading and releasing) which the application would have no knowledge of, 
possibly producing unpredictable results. 


DBCS Character-String Handling 
An application can input double-byte data to GDDM in either two modes: 


e Mixed: The double-byte characters are surrounded by shift-out and shift-in 
(SO/SI) characters. This is the default mode. 


e Nonbracketed: The double-byte data has no delimiting characters. In this 
mode, all character data received by GDDM is assumed to be double-byte. 


To switch from the default mode of mixed DBCS data to the nonbracketed mode, a 
call is made to the GSCS routine with a SYMBOL-SET-ID parameter value of 8. All 
subsequent character data received in GDDM routines are nonbracketed 
double-byte data. To switch back to the default mixed mode, a call to GSCS with a 
SYMBOL-SET-ID parameter value other than 8 must be made. 


If no DBCS language has been selected through the GSLSS call and a GSCS call 
is made with a SYMBOL-SET-ID parameter value of 8, GDDM issues a diagnostic 
message. The GDDM application remains in its previous DBCS mode. 


For mixed DBCS data, the user can control whether SO/SI characters appear as 
blanks in the character string output by calling the GSSEN routine. If the user calls 
GSSEN with a value of 0 or 1 for the MIXED parameter, then any SO/SI characters 
are output as blanks. If the user calls GSSEN with a value of 2 for the MIXED 
parameter, then the SO/SI characters do not take up any character position in the 
output string. The default is that SO/SI characters are output as blanks. 


The user may query the current setting of GSSEN through the GSQSEN routine. 
The value returned is the current setting of the MIXED value. 


DBCS Graphics-Capable Device Support 


Model GO1 and Model G02 of the 5555 device type have been added for DBCS 
graphics support. The G01 is color graphics-capable with monochrome text, and 
the Model G02 is color graphics-capable with color text. 


DBCS data may be input to GDDM or BGU through any double-byte-capable 
display (does not have to be graphics-capable), and may be output through any 
device currently supported by GDDM (does not have to be DBCS-capable). 


The data stream generated by GDDM for DBCS data is no different than that 
generated today. Because the graphics data streams for displays, printers, or 
plotters have DBCS-dependent data stream orders, the output generated can be 
displayed on any device currently supported by GDDM. 
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In order to interactively use GDDM or BGU (such as to input data, to display a 
chart, to modify chart), one of the new graphics-capable models of the 5555 device 


type is required. 


All plotters and printers (SCS or IPDS) which currently support GDDM also support 
DBCS graphics data. 


Hardware and Software Requirements for 5555 Models G01 and G02 
Hardware requirements for 5555 Models G01 and G02. 


¢ One of the following system units is required: 


— 5350-T 
— 5541-T 


— 5551-S,T,V 


— 5561-W 
— 5571-T,V 
— 5580-Y 


e¢ 5250 Adapter/A 


¢ One of the following keyboards: 
— Type! (5576-001) 
— Type Il (5576-002) 
— Type Ill (5576-003) 
¢ One of the following monitors: 
— 5574-C02,C05,C06,C07,C09,C19,M06,W06 


— 8515-A01 


Software requirements for 5555 Models G01 and G02. 
e Japanese DOS k3.3 or J4.0 


DBCS Error Handling 


Several diagnostic warning messages have been created for DBCS error handling. 
GDDM typically ignores the information which is not valid, and continues with the 


application. 


Figure D-5 (Page 1 of 2). DBCS Error Messages 


CPGO0111 


CPG0117 


CPG0118 


CPG0235 


CPG0236 


An attempt was made to process a double-byte character string when 
a DBCS language was not selected. The character string is output as 
blank characters. 


An attempt was made to load a DBCS language using a 
SYMBOL-SET-ID parameter value which is not valid. The language is 
not selected. 


An attempt was made to load a DBCS language using a 


SYMBOL-SET-TYPE parameter value which is not valid. The 
language is not selected. 


An attempt was made to load a DBCS language using a 
SYMBOL-SET-NAME parameter value which is not valid. The 
language is not selected. 


An attempt was made to load a DBCS symbol set which could not be 
found. The default symbol set is used. 
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Figure D-5 (Page 2 of 2). DBCS Error Messages 


CPG0237 


CPG3252 


CPG3253 


CPG3254 


CPG3264 


An attempt was made to select nonbracketed DBCS mode on the 
GSCS call when a DBCS language was not yet selected. The current 
mode is not changed. 


An attempt was made to process a DBCS string which was not ended 
by a shift-in character. A shift-in character is assumed at the last valid 
position in the string. 


An attempt was made to process a double-byte character whose code 
point is not valid. The character is treated as a DBCS blank 
character. 


An attempt was made to process a double-byte character whose ward 
is not valid. The character is treated as a DBCS blank character. 


An attempt is made to process a DBCS string with an odd length. 
The last byte in the character string is ignored. 
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Glossary 


This glossary includes terms and definitions from: 


¢ The American National Dictionary for Information 
Systems, ANSI X3.172-1990, copyright 1990 by the 
American National Standards Institute (ANSI). 
Copies may be purchased from the American 
National Standards Institute, 1430 Broadway, New 
York, New York 10018. Definitions are identified by 
the symbol (A) after the definition. 


e The Information Technology Vocabulary, developed 
by Subcommittee 1, Joint Technical Committee 1, of 
the International Organization for Standardization 
and the International Electrotechnical Committee 
(ISO/IEC JTC1/SC1). Definitions of published parts 
of this vocabulary are identified by the symbol (I) 
after the definition; definitions taken from draft 
international standards, committee drafts, and 
working papers being developed by ISO/IEC 
JTC1/SC1 are identified by the symbol (T) after the 
definition, indicating that final agreement has not yet 
been reached among the participating National 
Bodies of SC1. 


adapter card. The electrical circuits on a logic card 
that connect one device to another or to a computer. 


alphabetic character. (1) Any one of the letters A 
through Z or a through z or one of the characters #, $, 
or @. (2) In COBOL, a character that is one of the 26 
uppercase letters of the alphabet, or a space. (3) In 
BASIC, a character that is one of the 26 uppercase or 
26 lowercase letters of the alphabet. (4) In DDS and 
IDDU, any one of the uppercase letters A through Z or 
one of the characters #, $, or @. 


alphanumeric character. In COBOL, any character in 
the character set of the computer. 


alphanumeric cursor. In GDDM, a physical indicator 
on a display. The alphanumeric cursor may be moved 
from one hardware cell to another. 


American National Standard Code for Information 
Interchange (ASCII). The code developed by the 
American National Standards Institute for information 
exchange among data processing systems, data 
communications systems, and associated equipment. 
The ASCII character set consists of 7-bit control 
characters and symbolic characters, plus one parity bit. 


API. See application program interface (API). 


application. A particular business task, such as 
inventory control or accounts receivable. 
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application program. A program used to perform a 
particular data processing task, such as inventory 
control or payroll. 


application program interface (API). A functional 
interface supplied by the operating system or a 
separately orderable licensed program that allows an 
application program written in a high- or low-level 
language to use specific data or functions of the 
operating system or the licensed program. 


argument. In aC language function call, an 
expression that represents a value that the calling 
function passes to the function specified in the call. 


array. (1) In BASIC, a named set of data items, all of 
which are of the same type, arranged in a pattern (for 
example, rows and columns). An array can be implicitly 
declared through use or explicitly declared in a DIM 
statement. (2) In C and PL/I, a collection of one or 
more elements with identical characteristics, grouped 
into one or more dimensions. (3) In RPG, a series of 
elements with like characteristics. An array can be 
searched for a uniquely identified element, or elements 
in an array can be accessed by their position relative to 
other elements. Contrast with table. 


array element. In RPG, BASIC, and PL/I, one of the 
data items in an array. 


ASCII. See American National Standard Code for 
Information Interchange (ASCII). 


aspect ratio. In Client Access/400 and AS/400 
Business Graphics Utility, a ratio of one dimension to 
another. For example, the ratio of the width of the data 
to its height as it appears on the display. 


attribute. A characteristic or trait of one or more items. 


automatic ranging. In AS/400 Business Graphics 
Utility, the use of system-supplied values to determine 
the intervals on a chart so that the maximum and 
minimum data values can be represented on the work 
station or plotter. 


axis. In AS/400 Business Graphics Utility and GDDM, 
one of the intersecting horizontal or vertical scales 
where data values are plotted on a chart. 


axis grid lines. In AS/400 Business Graphics Utility 
and GDDM, straight lines extending perpendicular to 
either axis at each major tick. 


BGU. See /BM AS/400 Business Graphics Utility 
Version 2 (BGU). 


binary. A numbering system with a base of two (0 and 


1). 


binary floating-point value. In PL/I, an approximation 
of a real number in the form of a significand, which can 
be considered as a binary fraction, and an exponent, 
which can be considered as an integer exponent to the 
base of 2. 


binary format. Representation of a decimal value in 
which each field must be 2 or 4 bytes long. The sign (+ 
or -) is in the far left bit of the field, and the number 
value is in the remaining bits of the field. Positive 
numbers have a 0 in the sign bit and are in true form. 
Negative numbers have a 1 in the sign bit and are in 
twos complement form. 


bit constant. In PL/I, either a series of binary numbers 
enclosed in apostrophes and followed immediately by B 
or B1, or a series of hexadecimal numbers enclosed in 
apostrophes and followed immediately by B4. Contrast 
with character constant. 


bit string. A series of bits consisting of the values 0 
and 1. 


business graphics. See graphics. 


Business Graphics Utility (BGU). See /BM AS/400 
Business Graphics Utility Version 2 (BGU). 


call. In telephony, a physical or logical connection 
(association) between one or more parties ina 
telephone call. For example, a held call has two parties 
logically connected although they are physically 
disconnected. A partial call is a two-party call in which 
one of the two parties is a virtual party; this can be 
viewed as a transient stage of the telephone call. 


called program. A program that is the object of a 
CALL statement combined at run time with the calling 
program to produce a run unit. 


character. Any letter, number, or other symbol in the 
data character set that is part of the organization, 
control, or representation of data. 


character constant. (1) The actual character value (a 
symbol, quantity, or constant) in a source program that 
is itself data, instead of reference to a field that contains 
the data. Contrast with numeric constant. (2) In the C 
language, a character or an escape sequence enclosed 
in apostrophes. (3) In FORTRAN, a character enclosed 
in apostrophes. (4) In PL/I, a sequence of characters 
enclosed in apostrophes that keep the value of the 
string; for example, 'CONSTANT'. See also bit 
constant and hexadecimal constant. 


character grid. In AS/400 Business Graphics Utility, 
an invisible network of uniformly spaced horizontal and 
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vertical lines covering the chart area. Used by the 
AS/400 Business Graphics Utility to determine the 
physical dimensions of the chart and the placement of 
the data on it. 


character grid unit. In AS/400 Business Graphics 
Utility, the distance between two adjacent horizontal or 
vertical lines on a character grid. 


character key. A keyboard key that allows the user to 
type into the system the character shown on the key. 
See also function key. 


character set. (1) A group of characters used for a 
specific reason; for example, the set of characters the 
display station can display, the set of characters a 
printer can print, or a particular set of graphic 
characters in a code page; for example, the 256 
EBCDIC characters. (2) All the valid COBOL 
characters. 


character string. A sequence of consecutive 
characters that are used as a value. 


character variable. Character data whose value is 
assigned or changed while the program is running. 


chart format. In AS/400 Business Graphics Utility, an 
object containing chart characteristics, such as the chart 
type, chart heading, legend position, and so on. The 
chart format does not include the data values to be 
plotted. The system-recognized identifier for the object 
type is *CHTFMT. 


chart layout. In AS/400 Business Graphics Utility, the 
arrangement of the various parts in the chart area and 
surrounding margins. 


clipping. In GDDM, the process of cutting off the 
image at the border of the display but allowing the 
coordinates of the lines to extend beyond. 


closure line. In GDDM, a line added by the system to 
enclose an area being filled with a pattern, in instances 
when the routines that precede the GSENDA routine fail 
to form an enclosed area. 


code page. A particular assignment of hexadecimal 
identifiers to graphic characters. 


code point. One of the bit patterns assigned to a 
character in a character set. On the AS/400 system, a 
code point is represented by a hexadecimal number. 
For example, in code page 256 (EBCDIC), the letter “e” 
is assigned a code point of hex 85. 


column. In COBOL, a character position within a print 
line. The columns are numbered from one, by one, 
starting at the farthest-left character position of the print 
line and extending to the farthest-right position of the 
print line. 


comment. Source program information that is not 
translated by the compiler. A comment consists of the 
characters (on one or more lines) beginning with /* and 
ending with */. 


compile-time array. In RPG, an array that is compiled 
with the source program and becomes a permanent 
part of the program. Contrast with run-time array and 
prerun-time array. 


compile-time table. In RPG, a table that is built into 
the source program and that becomes a permanent part 
of the compiled program. Contrast with prerun-time 
table and run-time table. 


component. In Pascal, the name of each separate 
value, where a variable has multiple values in a 
structured type. 


computer graphics. The use of a computer to 
produce images of relationships, such as charts, and 
two- or three-dimensional drawings by means of dots, 
lines, curves, and so forth. 


constant. (1) Data that has an unchanging, 
predefined value to be used in processing. (2) In 
Pascal, a value that is either a literal or an identifier that 
has been associated with a value in a CONST 
declaration. (3) In RPG, data that has an unchanging, 
predefined value to be used in processing. A constant 
does not change during the running of a program, but 
the contents of a field or variable can. (4) In DB2/400, 
a language element that specifies a value. Constants 
are either string constants or numeric constants. See 
also literal. 


current mode. In GDDM, the characteristics of the 
controlling session. For example, when a color is 
defined, everything the program draws uses that color 
until the color is changed. 


current position. In GDDM, the position, in user 
coordinates, that becomes the starting point for the next 
graphics routine, if that routine does not explicitly 
specify a starting point. 


cursor. A movable symbol, often a blinking or solid 
block of light, that tells the display station user where to 
type, or identifies a choice to select. 


data description specifications (DDS). A description 

of the user’s database or device files that is entered into 
the system in a fixed form. The description is then used 
to create files. 


data file utility (DFU). The part of the Application 
Development ToolSet/400 licensed program that is used 
to enter, maintain, and display records in a database 
file. 


data group. (1) In AS/400 Business Graphics Utility, a 
collection of values that identify the comparisons in a 
chart. For example, the relative size of the slices in a 
pie chart or the relative height of the bars in a bar chart. 
See also paired data. Contrast with data value. (2) In 
GDDM, a collection of data values displayed, for 
example, as a pie chart or as the plotted points ona 
line of a line chart. More than one data group may be 
displayed on a chart. 


data value. In AS/400 Business Graphics Utility, a 
single, numeric data item entered as a value for a 
horizontal line or vertical line. Contrast with data group. 


database. All the data files stored in the system. 


database file. One of several types of the system 
object type *FILE kept in the system that contains 
descriptions of how input data is to be presented to a 
program from internal storage and how output data is to 
be presented to internal storage from a program. See 
also physical file and logical file. 


DDS. See data description specifications (DDS). 


debugging mode. An environment in which programs 
can be tested. 


decimal floating-point constant. In PL/I, a value 
consisting of a significand that contains a decimal 
fixed-point constant, and an exponent that contains the 
letter E followed by an optionally signed integer 
constant not exceeding three digits. 


decimal floating-point value. In PL/I, an 
approximation of a real number, in the form of a 
significand, which can be considered as a decimal 
fraction, and an exponent, which can be considered as 
an integer exponent to the base of 10. Contrast with 
binary floating-point value. 


default program. A user-specified program that is 
assumed when no other program is specifically named 
on a debug command, or a user-defined program for 
handling error messages. 


device class. The generic name for a group of device 
types. For example, all display stations belong to the 
same device class. Contrast with device type. 


device token. In GDDM, an 8-byte code, required to 
set the devices to a predefined set of hardware 
characteristics. 


device type. The generic name for a group of devices. 
For example, 5219 for IBM 5219 Printers. Contrast with 
device class. 


DFU. See daia file utility (DFU). 
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diagnostic message. A message that contains 
information about errors or possible errors. This 
message is generally followed by an escape message. 


digit. Any of the numerals from 0 through 9. 


dimension specification. In BASIC, the specification 
of the size of an array and the arrangement of its 
elements. Up to seven dimensions can be specified. 


display file. (1) A device file to support a display 
station. (2) In BASIC, any file that has the keyword 
DISPLAY specified in the OPEN statement for the file. 


display screen. The part of the display device, which 
is similar to a television (TV) picture tube, used to 
display information entered or received at a display 
station. 


display station. A device that includes a keyboard 
from which an operator can send information to the 
system and a display screen on which an operator can 
see the information sent to or the information received 
from the system. 


double-byte character. An entity that requires two 
character bytes. 


double-byte character set (DBCS). A set of 
characters in which each character is represented by 2 
bytes. Languages such as Japanese, Chinese, and 
Korean, which contain more symbols than can be 
represented by 256 code points, require double-byte 
character sets. Because each character requires 2 
bytes, the typing, displaying, and printing of DBCS 
characters requires hardware and programs that 
support DBCS. Four double-byte character sets are 
supported by the system: Japanese, Korean, Simplified 
Chinese, and Traditional Chinese. 


dummy device. In GDDM, an imaginary output device 
for which the program does all the normal processing 
but for which no actual output is received. 


EBCDIC. See extended binary-coded decimal 
interchange code (EBCDIC). 


element. (1) Ina list of parameter values, one value. 
(2) In BASIC, FORTRAN, and RPG, the smallest 
addressable unit of an array or table. 


element mark. In Advanced Function Printing 
Utilities/400, a mark that is used to show the position of 
an element on a display; for example, '*B005' where B 
means bar code and 005 is the fifth element. See also 
element and element name. 


element name. In Advanced Function Printing 
Utilities/400, a name that appears in the image area 
instead of an element mark. See also element and 
element mark. 
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extended binary-coded decimal interchange code 
(EBCDIC). A coded character set consisting of 8-bit 
coded characters. 


externally described data. Data contained in a file for 
which the fields and the records are described outside 
of the program (such as with files created by DDS, 
IDDU, or the DB2/400 licensed program) that processes 
the file. Contrast with program-described data. 


fillet. In GDDM, a curve that is tangent to the end 
points of two connected lines. See also polyfillet. 


floating-point format. (1) In binary floating-point 
representation, the storage format that represents a 
binary floating-point value. See also /ong format and 
short format. (2) In PL/I, a number shown as an 
optional sign, a decimal number with a decimal point, 
followed by the letter E, followed by an optional sign 
and a 1- to 3-digit integer. For example, 3.0E-2, is 3 
times 10 to the -2 power or 0.03. (3) In BASIC, a 
number shown as an optional sign followed by an 
integer or fixed-point constant, followed by the letter E, 
followed by an integer constant with up to 3 significant 
digits. 


function key. A keyboard key that allows the user to 
select keyboard functions or programmer functions. 
Contrast with character key. 


GDDM. See graphical data display manager (GDDM). 
GDF file. See graphics data format (GDF) file. 


graphical data display manager (GDDM). A function 
of the operating system that processes both text and 
graphics for output on a display, printer, or plotter. 
Contrast with presentation graphics routines (PGR). 


graphics. (1) Pictures and illustrations. (2) Pertaining 
to charts, tables, and their creation. See also computer 
graphics. 


graphics data format (GDF) file. A picture definition 
in a coded order format used internally by GDDM and, 
optionally, providing the user with a lower-level 
programming interface than the GDDM application 
programming interface. 


graphics field. In GDDM, that part of the display or 
the paper that is used for pictures and graphics text. 


graphics primitive. In GDDM, a single item of 
graphics information, such as a line or a string of 
graphics text. 


graphics segment. In GDDM, a group of graphics 
primitives (lines, arcs, and text) that are operated as a 
common set. The graphics primitives inside a graphics 
segment share characteristics, such as visibility and 


angle of rotation, but keep their individual 
characteristics, such as color and line width. 


graphics symbol set. In GDDM, an object that can 
contain either lines or images. The system-recognized 
identifier for the object type is *GSS. See also vector 
symbol set (VSS) and image symbol set (ISS). 


graphics text. In GDDM, text displayed by an 
application program using a graphics symbol set. 


graphics window. In GDDM, the view of the graphics 
picture that is defined by the range of the world 
coordinates specified by the user. 


hardware character. In GDDM, an alphanumeric 
character provided by the display station, usually from a 
display file. See also mode-2 character and mode-3 
character. 


hexadecimal. Pertaining to a numbering system with a 
base of 16. 


hexadecimal constant. In PL/I, a series of 
hexadecimal numbers enclosed in apostrophes that 
keep the value of the string. See also bit constant and 
character constant. 


high-level language (HLL). A programming language, 
such as RPG, BASIC, PL/I, Pascal, COBOL, and C 
used to write computer programs. 


HLL. See high-level language (HLL). 


hue. The gradual variations of colors such as blue, 
green, red, yellow, and so on. 


IBM AS/400 Business Graphics Utility Version 2 
(BGU). The IBM licensed program that can be used to 
design, plot, display, and print business charts. 


image. An electronic representation of an original 
document recorded by a scanning device. 


image symbol set (ISS). In GDDM, a graphics symbol 
set in which each character is treated as a small image 
and is described by a rectangular array of display 
points. Characters in an image symbol set are always 
drawn in a fixed size. Contrast with vector symbol set, 
see also graphics symbol set. 


imaginary line. In GDDM, a construction line used to 
build a fillet. The beginning and ending points of 
imaginary lines are defined, but the lines themselves do 
not appear as part of the picture. 


include statement. For OS/400 application 
programming interfaces, a statement that causes the 
compiler to replace the include statement with the 
contents of the specified header or file. 


integer. (1) A positive or negative whole number. 

(2) In COBOL, a numeric constant or a numeric data 
item that does not include any digit position to the right 
of the assumed decimal point. 


intelligent printer data stream (IPDS). (1) An 
all-points-addressable data stream that allows users to 
position text, images, and graphics at any defined point 
on a printed page. (2) In GDDM, a structured-field data 
stream for managing and controlling printer processes, 
allowing both data and controls to be sent to the printer. 


IPDS. See intelligent printer data stream (IPDS). 


join logical file. A logical file that combines (in one 
record format) fields from two or more physical files. 
See also /ogical file. 


keyword. In DDS, a name that identifies a function. 


legend. In AS/400 Business Graphics Utility and 
GDDM, an explanatory list of the symbols, lines, and 
shaded areas on a chart. 


library list. A list that indicates which libraries are to 
be searched and the order in which they are to be 
searched. The system-recognized identifier is *LIBL. 


lightness. The characteristic that allows colors to be 
put in order from light to dark. 


literal. In RPG, a character string whose value is 
defined by the characters themselves. For example, 
the numeric constant 7 has the value 7, and the 
character constant 'CHARACTERS' has the value 
CHARACTERS. See also constant, character constant, 
and numeric constant. 


load. To move data or programs into storage. 


logical file. A description of how data is to be 
presented to or received from a program. This type of 
database file contains no data, but it defines record 
formats for one or more physical files. See also join 
logical file and database file. Contrast with physical file. 


long format. In binary floating-point storage formats, 
the 64-bit representation of a binary floating-point 
number, not-a-number, or infinity. Contrast with short 
format. 


major tick. In AS/400 Business Graphics Utility, a 
mark on an axis that denotes character grid units ona 
chart. See also minor tick. 


minor tick. In AS/400 Business Graphics Utility, one 
of the marks located between major ticks on an axis of 
a chart. See also major tick. 

mode-2 character. In GDDM, a graphics character 
(symbol), characterized by an unchanging size, 
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constructed from picture elements. Contrast with 
mode-3 character, see also hardware character. 


mode-3 character. In GDDM, a graphics character 
(symbol), characterized by a variable size and shape, 
constructed from lines and curves. Contrast with 
mode-2 character, see also hardware character. 


nonpaired data. In AS/400 Business Graphics Utility 
and GDDM, data that is specified such that each 
X-value has a set of Y-values associated with it. 
Contrast with paired data. 


numeric constant. (1) The actual numeric value to be 
used in processing, instead of the name of a field 
containing the data. A numeric constant can contain 
any of the numeric digits 0 through 9, a sign (plus or 
minus), and a decimal point. See also floating-point 
constant. Contrast with character constant. (2) |n 
BASIC, the three allowable forms of numeric constants 
are integer, fixed-point, and floating-point. See also bit 
constant and hexadecimal constant. 


offset. In GDDM, the number of character grid units 
from a reference point. 


page. In GDDM, the picture or chart. All specified 
graphics are added to the current page. An output 
statement always sends the current page to the device. 


paired data. In AS/400 Business Graphics Utility and 
GDDM, data that is specified so that every X value has 
only one Y value associated with it. See also data 
group. Contrast with nonpaired data. 


parameter. A value supplied to a command or 
program that is used either as input or to control the 
actions of the command or program. 


parameter list. A list of values that provide a means 
of associating addressability of data defined in a called 
program with data in the calling program. It contains 
parameter names and the order in which they are to be 
associated in the calling and called program. 


pel. See picture element. 


physical file. A description of how data is to be 
presented to or received from a program and how data 
is actually stored in the database. A physical file 
contains one record format and one or more members. 
See also database file. Contrast with logical file. 


picture element. In computer graphics, the smallest 
element of a display area, such as a dot, that can be 
independently assigned color and intensity. 


picture space. In GDDM, the area of the page that 
contains the graphics. 
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plot. In GDDM, to represent graphically on paper 
using a plotting device. 


point. The second byte of a DBCS code, which 
uniquely identifies double-byte characters in the same 
ward. Contrast with ward. 


pointer. In Client Access/400, the symbol shown on a 
display or window that is moved by a pointing device, 
such as a mouse. 


polyfillet. In GDDM, a curve based on a sequence of 
lines. A polyfillet is a curved line that is tangent to the 
end points of the first and last lines and tangent to the 
midpoints of all other lines. See also fillet. 


polygon. In GDDM, a sequence of adjoining straight 
lines that enclose an area. 


polyline. In GDDM, a sequence of adjoining lines. 


prerun-time array. In RPG, an array that is loaded at 
the same time as the program, before the program 
actually begins to run. Contrast with compile-time array 
and run-time array. 


prerun-time table. In RPG, a table that is loaded at 
the same time as the source program, before the 
program actually begins to run. Contrast with 
compile-time table and run-time table. 


presentation graphics routines (PGR). A group of 
routines within the operating system that allows 
business charts to be defined and displayed 
procedurally through function routines. Contrast with 
graphical data display manager (GDDM). 


program-described data. Data contained in a file for 
which the fields in the records are described in the 
program that processes the file. Contrast with 
externally described data. 


reference line. In AS/400 Business Graphics Utility, a 
straight line parallel to either the vertical or horizontal 
axis relative to which data values are plotted on a chart. 
Sometimes called a translated axis line. 


run-time array. In RPG, an array that is loaded or 
created by input or calculation specifications after the 
program starts to run. Contrast with compile-time array 
and prerun-time array. 


run-time table. In RPG, a table that is loaded or 
created by input or calculation specifications after the 
program starts to run. Contrast with compile-time table 
and prerun-time table. 


saturation. The amounts of color and gray in a hue 
that affect its vividness; that is, a hue with high 
saturation contains more color and less gray than a hue 
with low saturation. See also hue and lightness. 


scalar. Pertaining to a single data item. Contrast with 
array. 


scale. (1) In GDDM, the number and progression of 
ticks along a vertical or horizontal axis. (2) In GDDM, 
to enlarge an image or marker. 


shear. In GDDM, the forward or backward slant of a 
mode-3 graphics symbol or string of such symbols 
relative to a line perpendicular to the baseline of the 
symbol. 


shift control character. See shift-in character and 
shift-out character. 


shift-in character. A control character (hex OF) that 
indicates the end of a string of double-byte characters. 
Contrast with shift-out character. 


shift-out character. A control character (hex OE) that 
indicates the start of a string of double-byte characters. 
Contrast with shift-in character. 


short format. In binary floating-point storage formats, 
the 32-bit representation of a binary floating-point 
number, not-a-number, or infinity. Contrast with long 
format. 


smoothness of curve. In GDDM, the connection of 
the plotted points in a data group by a continuous 
curve. On System/370 GDDM, called curve fitting. 


source statement. A statement written in symbols of a 
programming language. For example, AS/400 BASIC, 
AS/400 PL/I, COBOL/400, RPG/400, and DDS 
statements are source statements. 


sweep. In AFP support, the movement around an arc 
from the center point of the arc. 


symbol set. In AS/400 Business Graphics Utility, a 
supplied character set used for text strings on charts; 
for example, headings, legend text, labels, and notes. 


table. (1) In COBOL, a set of logically consecutive 
data items that are defined in the Data Division with the 
OCCURS clause. (2) In RPG, a series of elements 
with like characteristics. A table can be searched for a 
uniquely identified element, but elements in a table 
cannot be accessed by their position relative to other 
elements. Contrast with array. 


tangent. In GDDM, the single point at which a straight 
line meets a curve or surface. 


tick. In AS/400 Business Graphics Utility, a reference 
point on either the vertical or horizontal axis of some 


chart types that represents the location of specified data 
values. See also major tick and minor tick. 


translation table. An object that contains a set of 
hexadecimal characters used to translate one or more 
characters of data. The table can be used for 
translation of data being moved between the system 
and a device. For example, data stored in one national 
language character set may need to be displayed or 
entered on display devices that support a different 
national language character set. The table can also be 
used to specify an alternative collating sequence or field 
translation functions. The system-recognized identifier 
for the object type is *TBL. See also table. 


variable. A name used to represent data whose value 
can be changed while the program is running by 
referring to the name of the variable. 


vector. In GDDM, a directed line segment; a straight 
line between two points. 


vector symbol set (VSS). In GDDM, a set of 
characters each of which is treated as a small picture 
and is described by a sequence of lines and arcs. 
Characters in a vector symbol set can be drawn to 
scale, rotated, and positioned precisely. Contrast with 
image symbol set (ISS); see also graphics symbol set. 


viewport. In GDDM, a rectangular area within the 
picture space that defines where the output of the 
current page appears on the work station. 


ward. A section of a double-byte character set (DBCS) 
where the first byte of the DBCS codes belonging to 
that section are the same value. According to IBM 
standards for DBCS codes, there are 190 wards, and 
each ward has up to 190 points on which DBCS 
characters can be assigned. Contrast with point. 


work station. A device used to transmit information to 
or receive information from a computer; for example, a 
display station or printer. 


work station function (WSF). The part of the Client 
Access/400 licensed program for DOS users that allows 
a personal computer attached to an AS/400 system to 
emulate up to five display stations, and a PC printer to 
emulate a system printer. 


world coordinates. In GDDM, the user-defined set of 
coordinates that define the graphics window, and that 
serve as the horizontal and vertical range for all 
graphics primitives within the graphics window. 


WSF. See work station function (WSF). 
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Bibliography 


The following AS/400 books contain information you 
may need. The books are listed with their full title and 
base order number. When these books are referred to 
in this book, the short title is used. 


BGU User’s Guide and Reference, SC09-1408, 
provides the application programmer, programmer, 
system administrator, or business or technical 
professional with information about using the 
AS/400 Business Graphics Utility (BGU) to create 
various types of charts. It is divided into two 
sections: the first section includes several 
exercises that familiarize the user with the functions 
of BGU, and the second section contains reference 
material. 


DDS Reference, SC41-3712, provides the 
application programmer with detailed descriptions of 
the entries and keywords needed to describe 
database files (both logical and physical) and 
certain device files (for displays, printers, and ICF) 
external to the user’s programs. 


Local Device Configuration, SC41-3121, provides 
the system operator or system administrator with 
information on how to do an initial configuration and 
how to change that configuration. This book also 
contains conceptual information about device 
configuration. 


BASIC User’s Guide and Reference, SC09-1823, 
provides the application programmer with the 
information needed to write, test, and maintain 
AS/400 BASIC programs in both the AS/400 
environment and the System/38 environment. 


Pascal User’s Guide, SC09-1844, provides the 
application programmer with information about how 
to use the AS/400 Pascal compiler. The book 
explains how to enter, compile, run, and debug 
AS/400 Pascal programs. It also describes how to 
use input and output (I/O) function and storage. 


PL/I User’s Guide and Reference, SC09-1825, 
provides the application programmer with 
information about using AS/400 PL/I in the 
System/38 environment. Differences between the 
System/38 environment and the AS/400 
environment are identified as well as the 
enhancements available in the AS/400 environment. 


COBOL/400 User’s Guide, SC09-1812, provides the 
application programmer with the information needed 
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to design, write, test, and maintain COBOL/400 
programs on the AS/400 system. 


COBOL/400 supports the ANSI 85 
intermediate-level COBOL. 


RPG/400 User’s Guide, SC09-1816, provides the 
application programmer with the information needed 
to write, test, and maintain RPG/400 programs on 
the AS/400 system. The book provides information 
on data organizations, data formats, file processing, 
multiple file processing, automatic report function, 
RPG command statements, testing and debugging 
functions, application design techniques, problem 
analysis, and compiler service information. The 
differences between the System/38 RPG Ill, 
System/38 compatible RPG, and RPG/400 are 
identified. 


Software Installation, SC41-3120, provides the 
system operator or system administrator with 
step-by-step procedures for initial installation, 
installing licensed programs, program temporary 
fixes (PTFS), and secondary languages from IBM. 


CL Programming, SC41-3721, provides the 
application programmer or programmer with a 
wide-ranging discussion of AS/400 programming 
topics. Included in the guide are discussions about 
objects and libraries, control language (CL) 
programming, messages and message handling, 
how to define and create user-defined commands 
and menus, and application testing. 


CL Reference, SC41-3722, provides the application 
programmer with a description of the AS/400 control 
language (CL) and its commands. Each command 
description includes a syntax diagram, parameters, 
default values, keywords, and an example. The 
information should be used to refer to the control 
language commands to request functions of the 
Operating System/400 (5763-SS1) licensed program 
and of the various languages and utilities. 


GDDM Programming, SC41-3717, provides the 
application programmer with information about using 
OS/400 graphical data display manager (GDDM) to 
write graphics application programs. 


This book includes many example programs and 
information to help managers and planners 
understand how the product fits into data 
processing systems. 
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Special Characters 
* (device token for DSOPEN) 2-8 
*PLOT device token 2-7 


Numerics 
4214 device token 2-7 
5182 color printer 
See printers 
522X device token 2-7 
5292 Model 2 
See display device 
5292M2 (device token for DSOPEN) 2-8 
5555 device token 2-7 
5555-G01 
hardware requirements D-6 
software requirements D-6 
5555-G02 
hardware requirements D-6 
software requirements D-6 
6180 device token 2-7 
7371 device token 2-7 
7372 (device token for DSOPEN) 2-9 


A 


ABPIE option 3-74 
ABREV option 3-67 
absolute data 3-67 
ADMxxxxx (supplied symbol sets) 2-92 
alarm (FSALRM) 2-27 
ALPHANUMERIC option 
CHYSET 3-105 
angle 
character angle, GDF order B-12 
GSCA (set current character angle) 2-50 
GSQCA (query current character angle) 2-112 
GSQCH (query character shear) 2-116 
annotation, additional 
CHNOFF (specify offsets for CHNOTE) 3-47 
CHNOTE (specify note) 3-48 
arc 
GDF order B-10 
GSARC (draw circular arc) 2-45 
GSELPS (draw elliptical arc) 2-74 
area 
CHAREA (chart) 3-11 
end (GDF) order B-11 
GDF order B-11 
GSAREA (start shaded area) 2-47 
relationship between pies 3-75 
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arrays 
specifying in BASIC 1-4 
specifying in COBOL/400 1-6 
specifying in PL/I 1-9 
specifying in RPG/400 1-24 
aspect ratio 2-108 
ASREAD (device output/input) 2-4 
ATABOVE option 3-102 
ATCENTER option 3-102 
ATEND option 3-102 
attributes 
axis labels) 3-95 
CHBATT (set framing box) 3-14 
CHDATT (datum line) 3-19 
CHGATT (grid lines) 3-23 
CHHATT (heading text) 3-26 
CHKATT (legend text) 3-32 
CHLATT (axis label) 3-40 
CHNATT (notes) 3-45 
CHTATT (text) 3-81 
CHVATT (values in bar and pie charts) 3-84 
GDF treatment of B-9 
attributes of values text in bar and pie charts 
(CHVATT) 3-84 
automatic axis drawing, control of 3-72 
axis 
characteristics 
CHAATT (line attributes) 3-9 
CHXRNG, CHYRNG (explicit ranges) 3-98 
CHXSET, CHYSET (axis label type) 3-104 
CHXSET, CHYSET (axis scale type) 3-101 
CHXTIC, CHYTIC (scale mark interval) 3-106 
y-axis label type (CHYSET) 3-104 
y-axis line occurrence (CHYSET) 3-102 
y-axis scale-mark style (CHYSET) 3-103 
duplicate 3-76 
label type (CHXSET, CHYSET) 3-104 
labels 
CHLATT (text attributes) 3-40 
CHXDAY, CHYDAY (day) 3-90 
CHXLAB, CHYLAB (text) 3-94 
CHXLAT, CHYLAT 3-95 
CHXMTH, CHYMTH (month) 3-97 
CHXSCL, CHYSCL (scale factor) 3-99 
y-axis label position (CHYSET) 3-103 
line 
attributes (CHAATT) 3-9 
CHYSET 3-102 
orientation 3-76 
placement 
CHXINT, CHYINT (specify intercept) 3-93 
scale type 
CHXSET, CHYSET 3-101 


axis (continued) 
selection 
CHXSEL, CHYSEL 3-100 
duplicate 3-76 
time of drawing 
CHDRAX 3-20 
titling 
CHTATT (text attributes) 3-81 
CHXTTL, CHYTTL (axis title specification) 3-108 
axis label text attributes (CHLATT) 3-40 
axis line attributes (CHAATT) 3-9 
AXIS option 
CHYSET 3-102 
axis title text attributes (CHTATT) 3-81 


bar chart 
CHBAR (plotting call) 3-12 
CHGAP (spacing between bars) 3-22 
CHGGAP (spacing between bar groups) 3-25 
controlling bar values 3-69 
horizontal bars 3-76 
MBAR, CBAR, and FBAR options 3-73 
NONBOX and NBOX options 3-74 
spacing between bar groups (CHGGAP) 3-25 
spacing between bars (CHGAP) 3-22 
bar value characters (CHVCHR) 3-86 
bar-chart values 
inside/on top of bar 3-76 
bar-value areas, blanking 3-68 
base position, legend (CHKEYP) 3-36 
BASIC, graphics considerations 1-3 
begin graphics image, GDF order B-18 
binary integers 
specifying in BASIC 1-3 
specifying in COBOL/400 1-5 
specifying in DDS 1-32 
specifying in Pascal 1-10 
specifying in PL/I 1-7 
specifying in RPG/400 1-20 
BKEY option 3-68 
BLABEL option 3-68 
blanking 
axis-label areas 3-68 
bar-value areas 3-68 
note areas 3-68 
BNOT option 3-48 
BNOTE option 3-68 
box round chart notes 3-74 
box size (GSCB) 2-52 
box, framing 
set attributes 3-14 
box, GDF order B-12 
BVALUES option 3-68 


X-2 AS/400 GDDM Reference 


Cc 


CBACK option 3-68 
CBAR option 3-74 
CBOX option 3-68 
CHAATT (axis line attributes) 3-9 
character 

write character GDF order B-14 
character angle 

GDF order B-12 

GSCA (set) 2-50 

GSQCA (query) 2-112 
character box 

GDF order B-12 

query size (GSQCB) 2-113 

set size (GSCB) 2-52 
character direction 

GDF order B-13 

query (GSQCD) 2-114 

set current (GSCD) 2-55 
character grid units, CHCGRD 3-16 
character mode 

GDF order B-13 

GSCM (set) 2-66 
character set 

double-byte support D-1 

GDF order B-14 

Japanese D-3 

Korean D-3 

simplified Chinese D-3 

traditional Chinese D-3 
character shear 

GDF order B-15 

query (GSQCH) 2-116 

set (GSCH) 2-57 
character spacing/size (CHCGRD) 3-16 
character string 

DBCS _D-5 

draw at current position (GSCHAP) 2-60 

draw at specified point (GSCHAR) 2-62 
character strings 

specifying in BASIC 1-3 

specifying in COBOL/400 1-5 

specifying in DDS 1-32 

specifying in Pascal 1-10 

specifying in PL/I 1-7 

specifying in RPG/400 1-20 
character, shift-control 

See shift-control characters 
characteristics 

DSQDEV (query device) 2-20 

FSQDEV 2-39 

FSQDEV (query device) 2-39 
CHAREA (chart area) 3-11 
chart 

area (CHAREA) 3-11 


chart (continued) 
construction 
CHDRAX (specify control of axis drawing) 3-20 
plotting histograms 3-29 
plotting line graphs and scatter plots 3-62 
plotting surface charts 3-79 
framing box 3-68 
heading 
CHHATT (heading text attributes) 3-26 
CHHEAD (heading text) 3-28 
layout specifications 
CHBATT (set framing box attributes) 3-14 
CHCGRD (basic character spacing/size) 3-16 
CHHMAR (bottom and top margins) 3-31 
CHVMAR (left and right margins) 3-89 
margin specifications 
CHHMAR_ 3-31 
CHVMAR (left and right margins) 3-89 
options (CHSET) 3-65 
chart area (CHAREA) 3-11 
chart notes, boxed 3-74 
CHBAR (plot a bar chart) 3-12 
CHBATT (set framing box attributes) 3-14 
CHCGRD (character spacing/size) 3-16 
CHCOL (component color table) 3-18 
CHDATT (datum line attributes) 3-19 
CHDRAX (specify control of axis drawing) 3-20 
CHFINE (curve fitting smoothness) 3-21 
CHGAP (spacing between bars) 3-22 
CHGATT (grid line attributes) 3-23 
CHGGAP (spacing between bar groups) 3-25 
CHHATT (heading text atiributes) 3-26 
CHHEAD (heading text) 3-28 
CHHIST (plot a histogram) 3-29 
CHHMAR (bottom and top margins) 3-31 
CHKATT (legend text attributes) 3-32 
CHKEY (legend key labels) 3-34 
CHKEYP (legend base position) 3-36 
CHKMAX (maximum legend width/height) 3-37 
CHKOFF (legend offsets) 3-39 
CHLATT (set axis label text attributes) 3-40 
CHLT (component line type table) 3-42 
CHLW (component line width table) 3-43 
CHMARK (component marker table) 3-44 
CHNATT (specify attributes for notes) 3-45 
CHNOFF (specify offsets for CHNOTE) 3-47 
CHNOTE (construct character string at designated 
position) 3-48 
CHNUM (set number of components) 3-54 
CHPAT (component shading pattern table) 3-55 
CHPCTL (control pie chart slices) 3-56 
CHPEXP (exploded slices in pie chart) 3-57 
CHPIE (plotting pie charts) 3-59 
CHPIER (pie reduction) 3-61 
CHPLOT (line graphs and scatter plots) 3-62 


CHRNIT (reinitialize Presentation Graphics 
routines) 3-64 
CHSET (set chart options) 
area relationship between pies 3-75 
bar chart type 3-73 
blanking 
axis-label areas 3-68 
bar-value areas 3-68 
note areas 3-68 
chart framing box 3-68 
control of automatic axis drawing 3-72 
controlling bar values 3-69 
conventions for displaying numeric data 
values 3-74 
curve fitting 3-69 
data relative or absolute 3-67 
duplicate axis selection 3-76 
framing box round chart notes 3-74 
heading 
justification 3-72 
occurrence 3-72 
position 3-72 
histogram risers 3-75 
legend 
blanking 3-68 
box 3-72 
legend or no legend 3-73 
lines on line graph 3-73 
markers on line graph 3-73 
month or day abbreviations 3-67 
order of key entries in legend 3-73 
pie chart 
data type 3-74 
label configuration 3-75 
spider appearance 3-75 
placing bar-chart values 3-76 
shading 3-71 
summary of options 3-65 
surface chart type 3-74 
CHSTRT (reset processing state to state 1) 3-78 
CHSURF (surface charts) 3-79 
CHTATT (axis title text attributes) 3-81 
CHTERM (terminate Presentation Graphics 
routines) 3-83 
CHVATT (attributes of values text in bar and pie 
charts) 3-84 
CHVCHR (number of bar value characters) 3-86 
CHVENN (Venn diagram) 3-87 
CHVMAR (left and right margins) 3-89 
CHXDAY, CHYDAY (day labels) 3-90 
CHXDTM, CHYDTM (specify translated axis lines or 
datum lines) 3-91 
CHXINT, CHYINT (specify intercept) 3-93 
CHXLAB, CHYLAB (label text) 3-94 
CHXLAT (x axis label attributes) 3-95 
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CHXMTH, CHYMTH (month labels) 3-97 
CHXRNG, CHYRNG (explicit ranges) 3-98 
CHXSCL, CHYSCL (scale factor) 3-99 
CHXSEL, CHYSEL (axis selection) 3-100 
CHXSET, CHYSET 
axis 
label type 3-104 
scale type 3-101 
specify axis options 3-101 
CHXTIC, CHYTIC 
scale mark interval 3-106 
CHXTTL, CHYTTL 
text specification 3-108 
CHYDAY, CHXDAY (day labels) 3-90 


CHYDTM, CHXDTM (specify translated axis lines or 


datum lines) 3-91 
CHYINT, CHXINT (specify intercept) 3-93 
CHYLAB, CHXLAB (label text) 3-94 
CHYLAT (y axis label attributes) 3-95 
CHYMTH, CHXMTH (month labels) 3-97 
CHYRNG, CHXRNG (explicit ranges) 3-98 
CHYSCL, CHXSCL (scale factor) 3-99 
CHYSEL, CHXSEL (axis selection) 3-100 
CHYSET (y-axis options) 
axis 
label type 3-104 
line occurrence 3-102 
grid lines 3-102 
label 
position 3-103 
type 3-104 
scale-mark style 3-103 
CHYSET, CHXSET (specify axis option) 3-101 
circular arc, draw (GSARC) 2-45 
clear current page (FSPCLR) 2-32 
clear the graphics field (GSCLR) 2-65 
clipping 
enable and disable (GSCLP) 2-64 
mode, query (GSQCLP) 2-117 
close 
current segment (GSSCLS) 2-142 
device (DSCLS) 2-5 
segment (GDF order) B-25 
COBOL/400, graphics considerations 1-5 
code point D-2 
code scheme 
DBCS (double-byte character set) code 
scheme D-2 
double-byte D-1 
double-byte character set (DBCS) D-2 
host system D-2 
personal computer D-2 
single-byte D-1 
color 
GSCOL (set current color) 2-68 
GSQCOL (query current) 2-119 
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color (continued) 
mix (GDF order) B-16 
mixing mode, query current (GSQMIX) 2-129 
mixing mode, set current (GSMIX) 2-98 
set extended (GDF order) B-16 
specify color (GDF order) B-15 
color numbers C-1 
color table 
defining (GSCTD) 2-71 
query (GSQCT) 2-122 
query definition of (GSQCTD) 2-123 
select (GSCT) 2-70 
comment GDF order B-17 
compatibility 
description A-1 
with IBM BASIC A-16 
with System/370 A-1 
component appearance 
CHCOL (component color table) 3-18 
CHLT (component line type table) 3-42 
CHLW (component line width table) 3-43 
CHMARK (component marker table) 3-44 
CHPAT (component shading pattern table) 3-55 
components 
set, number of (CHNUM) 3-54 
construct character string at designated position 
(CHNOTE) 3-48 
control 
automatic axis drawing 3-72 
bar-chart values 3-69 
functions 
CHRNIT (reinitialize Presentation Graphics 
routines) 3-64 


CHSTRT (reset processing state to state 1) 3-78 


CHTERM (terminate Presentation Graphics 
routines) 3-83 
pie chart slices 3-56 
control character, shift 
See shift-control characters 
control characters 
key symbol substitution 3-35 
line break 3-35 
controlled bar-chart values 3-69 
conventions for displaying numeric data values 
(CHSET) 3-74 
conversion (see compatibility) A-1 
coordinate lengths in GDF B-9 
coordinates, define world (GSWIN) 
create page (FSPCRT) 2-33 
create segment (GSSEG) 2-144 
current character mode, query (GSQCM) 2-118 
current position 
change without drawing 2-100 
GDF B-8 
query (GSQCP) 2-120 


cursor query (GSQCUR) 2-124 
curve fitting smoothness 
CURVE option (CHSET) 3-69 
curve fitting smoothness (CHFINE) 3-21 
CVALUES option 3-69 


D 


data description specifications 
data types in 1-32 
data group appearance 
CHFINE (curve fitting smoothness) 3-21 
data type 3-67 
data types 
in BASIC 1-3 
in COBOL/400_ 1-5 
inDDS_ 1-32 
in Pascal 1-10 
in PL/| 1-7 
in RPG/400_ 1-20 
data types by routine 
GDDM summary table 2-149 
Presentation Graphics routines summary 
table 3-110 
data values, displaying on charts 3-69 
DATE option 3-105 
datum lines 
CHDATT (attributes) 3-19 
CHXDTM, CHYDTM (specify) 3-91 
day labels (CHXDAY, CHYDAY) 3-90 
day labels, abbreviations 3-67 
DBCS 
error handling D-6 
graphics-capable device support D-5 
language support D-3 
symbol set naming convention D-4 
symbol-set handling D-3 
DBCS character string 
handling D-5 
DDS, data types in 1-32 


decimal places, rules for displaying on charts 3-70 


default color numbers C-1 
default line-type numbers C-2 
default marker numbers C-2 
default printer file(QPGDDM) 2-17 
default shading pattern numbers C-3 
define color table (GSCTD) 2-71 
define graphics field (GSFLD) 2-77 
define picture space (GSPS) 2-108 
define viewport (GSVIEW) 2-147 
define window (GSWIN) 2-148 
delete page (FSPDEL) 2-35 
delete segment (GSSDEL) 2-143 
device 

close (DSCLS) 2-5 

discontinue usage (DSDROP) 2-6 


device (continued) 

open (DSOPEN) 2-7 

output/input (ASREAD) 2-4 

query characteristics (DSQDEV) 2-20 

query usage (DSQUSE) 2-24 

reinitialize (DSRNIT) 2-25 

specify usage (DSUSE) 2-26 
device output/input (ASREAD) 2-4 
device tokens 2-7 
device tokens for DSOPEN 2-9 
device-id, query unique (DSQUID) 2-23 
devices needed for graphics 1-1 
direction, character 

GDF order B-13 

GSCD (set current direction) 2-55 

GSQCD (query current direction) 2-114 
disable clipping (GSCLP) 2-64 
discontinue device usage (DSDROP) 2-6 
display color numbers C-1 
display device 1-1 
display line-type numbers C-2 
display marker numbers C-2 
display outstanding graphics (FSFRCE) 
display shading pattern numbers C-3 
double-byte 

character set support D-1 
double-byte character 

identifying a string of D-2 

string beginning D-2 

string ending D-2 
double-byte character set 

GDDM support D-3 
double-byte data 

basic information D-1 
double-byte input mode 

default D-5 

mixed D-5 

non-bracketed D-5 
double-byte language 

selecting D-3 
draw 

circular arc (GSARC) 2-45 

curved fillet (GSPFLT) 2-105 


2-30 


data from graphics data format file (GSPUT) 


elliptical arc (GSELPS) 2-74 

graphics image (GSIMG) 2-86 

marker symbol (GSMARK) 2-97 
scaled graphics image (GSIMGS) 2-89 
series of lines (GSPLNE) 2-107 


series of marker symbols (GSMRKS) 2-101 


straight line (GSLINE) 2-91 
draw character string 
at current position (GSCHAP) 2-60 
at specified point (GSCHAR) 2-62 
DRAW option 3-72 


Index 


2-110 
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drop, discontinue device (DSDROP) 2-6 
DSCLS (close device) 2-5 
DSDROP (discontinue device usage) 2-6 
DSOPEN (open device) 2-7 
DSQDEV (query device characteristics) 2-20 
DSQUID (query unique device-id) 2-23 
DSQUSE (query device usage) 2-24 
DSRNIT (reinitialize device) 2-25 
DSUSE (specify device usage) 2-26 
dummy device 
resulting from device token L79A3 2-10 
resulting from DSOPEN parameters 2-10 
duplicate axis selection 3-76 


E 


elliptical arc, draw (GSELPS) 2-74 
enable and disable clipping (GSCLP) 2-64 
end 

graphics image GDF order B-19 

retrieval of graphics data (GSGETE) 2-83 

shaded area (GSENDA) 2-76 
error exits 

specify (FSEXIT) 2-28 
error handling 

DBCS D-6 

diagnostic warning messages D-6 
errors, unexpected legend position 3-34 
explicit ranges (CHYRNG, CHXRNG) 3-98 
exploded slices in pie charts (CHPEXP) 3-57 


F 


family 
returned from DSQDEV 2-21 
specified in DSOPEN 2-8 
FBAR option 3-74 
field 
clear graphics field (GSCLR) 2-65 
define graphics field (GSFLD) 2-77 
FILL option 3-71 
fillet 
GDF order B-17 
GSPFLT 2-105 
floating-point numbers 
specifying in BASIC 1-3 
specifying in COBOL/400 1-5 
specifying in DDS 1-32 
specifying in Pascal 1-10 
specifying in PL/I 1-7 
specifying in RPG/400 1-20 
FORCEZERO option 3-102 
framing box round chart notes 3-74 
FSALRM (sound device alarm) 2-27 
FSEXIT (specify error exit) 2-28 
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FSFRCE (display outstanding graphics) 2-30 

FSINIT (initialize graphics) 2-31 

FSPCLR (clear current page) 2-32 

FSPCRT (create page) 2-33 

FSPDEL (delete page) 2-35 

FSPQRY (query specified page) 2-36 

FSPSEL (select page) 2-37 

FSQCPG (query current page-id) 2-38 

FSQDEV (query device characteristics) 2-39 

FSQERR (query last error) 2-40 

FSQUPG (query unique page-id) 2-41 

FSREST (retransmit data) 2-42 

FSRNIT (reinitialize graphics) 2-43 

FSTERM (terminate graphics) 2-44 

FULL option 3-67 

function summary with differences between 
System/370 and the AS/400 System A-1 


G 


GDDM 
double-byte data input D-5 

GDF (graphics data format) 
arc order B-10 
area end order B-11 
area order B-11 
attributes GDF orders B-9 
character angle order B-12 
character box order B-12 
character direction order B-13 
character mode order B-13 
character order B-14 
character set order B-14 
character shear order B-15 
color mix order B-16 
color order B-15 
color set extended order B-16 
comment order B-1, B-17 
current position B-8 
fillet order B-17 
GDF order descriptions B-1 
GDF order formats B-7 
GDF order syntax B-9 
graphics image order, data B-19 
GSGET (retrieve graphics data as GDF) 2-80 
GSGETE (end retrieval of GDF) 2-83 
GSGETS (start retrieval of GDF) 2-84 
GSPUT (draw data from) 2-110 
line order B-20 
line relative order B-21 
line type order B-21 
line width order B-22 
list of GDF orders B-2 
marker order B-22 
marker type order B-23 
order formats (GDF) B-7 


GDF (graphics data format) (continued) 
orders accepted but not generated B-6 
padding or GDF order descriptions B-8 
pattern order B-23 
segment close order B-25 
set arc parameters order B-10 
set tag order B-25 
text attributes B-13 

GDF (graphics data format) file 
orders generated by device B-5 

graphics data file 
GSGET (retrieve graphics data as GDF) 2-80 
GSGETE (end retrieval of GDF) 2-83 
GSGETS (start retrieval of GDF) 2-84 

graphics data format 
GDF order descriptions B-1 

graphics data format file 
GSPUT (draw data from) 2-110 

graphics field 
clear (GSCLR) 2-65 
define (GSFLD) 2-77 

graphics image 
GDF order, begin B-18 
GDF order, end B-19 
GDF order, write data B-19 
GSIMG (draw graphics image) 2-86 


graphics image, drawing scaled (GSIMGS) 2-89 


graphics primitives, through GDF B-8 
graphics symbol sets 
load from auxiliary storage 2-92 
with OS/400 Graphics 2-92 
graphics-capable device 
DBCS support D-5 
graphs, plotting line 3-62 
grid line attributes (CHGATT) 3-23 
grid lines 
CHGATT (grid line attributes) 3-23 
CHYSET 3-102 
GRID option 
CHYSET 3-102 
GSARC (draw a circular arc) 2-45 
GSAREA (start a shaded area) 2-47 
GSCA (set current character angle) 2-50 
GSCB (set character-box size) 2-52 
GSCD (set current character direction) 2-55 
GSCH (set current character shear) 2-57 
GSCHAP (draw a character string at current 
position) 2-60 
GSCHAR (draw character string at specified 
point) 2-62 
GSCLP (enable and disable clipping) 2-64 
GSCLR (clear the graphics field) 2-65 
GSCM (set current character mode) 2-66 
GSCOL (set current color) 2-68 
GSCS (set current symbol set) 2-69 


GSCT (select color table) 2-70 
GSCTD (define color table) 2-71 
GSELPS (draw elliptical arc) 2-74 
GSENDA (end shaded area) 2-76 
GSFLD (define graphics field) 2-77 
GSFLW (set fractional line width) 2-79 
GSGET (retrieve graphics data as GDF) 2-80 
GSGETE (end retrieval of graphics data) 2-83 
GSGETS (start retrieval of graphics data) 2-84 
GSIMG (draw graphics image) 2-86 
GSIMGS (draw scaled graphics image) 2-89 
GSLINE (draw straight line) 2-91 
GSLSS (load graphics symbol set from auxiliary 
storage) 2-92 
GSLT (set current line type) 2-95 
GSLW (set current line width) 2-96 
GSMARK (draw marker symbol) 2-97 
GSMIX (set current color-mixing mode) 2-98 
GSMOVE (move without drawing) 2-100 
GSMRKS (draw series of marker symbols) 2-101 
GSMS (set current marker symbol) 2-102 
GSMSC (set marker scale) 2-103 
GSPAT (set current shading pattern) 2-104 
GSPFLT (draw curved fillet) 2-105 
GSPLNE (draw series of lines) 2-107 
GSPS (define picture space) 2-108 
GSPUT (draw data from graphics data format 
file) 2-110 
GSQCA (query current character angle) 2-112 
GSQCB (query current character box size) 2-113 
GSQCD (query current character direction) 2-114 
GSQCEL (query current hardware cell size) 2-115 
GSQCH (query current character shear) 2-116 
GSQCLP (query clipping mode) 2-117 
GSQCM (query current character mode) 2-118 
GSQCOL (query current color) 2-119 
GSQCP (query current position) 2-120 
GSQCS (query current symbol-set identifier) 2-121 
GSQCT (query current color table) 2-122 
GSQCTD (query color table definition) 2-123 
GSQCUR (query cursor position) 2-124 
GSQFLW (query current fractional line width) 2-125 
GSQLT (query current line type) 2-126 
GSQLW (query current line width) 2-127 
GSQMAX (query number of segments) 2-128 
GSQMIX (query current color-mixing mode) 2-129 
GSQMS (query current marker symbol) 2-130 
GSQMSC (query current marker scale) 2-131 
GSQNSS (query number of loaded symbol 
sets) 2-132 
GSQPAT (query current shading pattern) 2-133 
GSQPS (query picture space definition) 2-134 
GSQSEN (query mixed string attribute of graphic 
text) 2-135 
GSQSS (query loaded symbol sets) 2-136 
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GSQTB (query text box) 2-137 ] 
GSQVIE (query current viewport definition) 2-139 


GSQWIN (query current window definition) 2-140 IBM BASIC, compatibility with A-16 
GSRSS (releasing graphics symbol set) 2-141 IBM plotters 1-1 
GSSCLS (close current segment) 2-142 IBM-host code scheme 
GSSDEL (delete segment) 2-143 illustration D-2 
GSSEG (create segment) 2-144 IBM-supplied objects 
GSSEN (set mixed string attribute of graphic library QGDDM = 1-2 
text) 2-145 IDRAW option 3-72 
GSVECM (vectors) 2-146 INCLUDES, in PL/I 1-7 
GSVIEW (define viewport) 2-147 INFILL option 3-71 
GSWIN (define window) 2-148 initialize graphics (FSINIT) 2-31 


integer numbers (see also binary integers) 1-3 
intelligent printer data stream* (IPDS) 2-10 


H INTERCEPT option 3-103 
handling DBCS character string D-5 intercept, specify (CHXINT, CHYINT) 3-93 
handling DBCS errors D-6 IPDS (intelligent printer data stream) 2-10 
hardware cell size, query (GSQCEL) 2-115 
hardware needed for graphics 1-1 K 
hardware requirements . 
5555-G01 D-6 KBOX option 3-72 
5555-G02 D-6 key symbol substitution character, in CHKEY 3-35 
keyboard D-6 key symbol substitution control character 3-35 
monitor D-6 KNORMAL option 3-73 


system unit D-6 KREVERSED option 3-73 


HBOTTOM option 3-72 
HCENTER option 3-72 L 


Let ea eee L79A3, device token specified in DSOPEN 2-10 
eee LABADJACENT option 


occurrence 3-72 CHYSET 3-103 
position 3-72 label 


specifying wording (CHHEAD) 3-28 eibaiieadoreates 
text attributes (CHHATT) 3-26 
; CHXLAT, CHYLAT 3-95 
HEADING option 3-72 ' . ; 

‘ configuration for a pie chart 3-75 
heading text (CHHEAD) 3-28 legend key (CHKEY) 3-34 
heading text attributes (CHHATT) 3-26 position 
HEX$ (built-in function in BASIC) : 

y axis (CHYSET) 3-103 
used for GSCHAP and GSCHAR_ 2-60 text (CHXLAB, CHYLAB) 3-94 


aig pu ee ove type (CHXSET, CHYSET) 3-104 
i ee ra : labels (CHXDAY, CHYDAY) 3-90 
mgnaev el nahgueges labels (CHXMTH, CHYMTH) 3-97 


BASIC 1-3 LABMIDDLE option 
COBOL/400 1-5 
CHYSET 3-103 
DDS 1-32 language 
— ie ses OS/400 Graphics 1-2 double-byte D-3 
Are : ; language support 
RPG/400 1-18 pues 
; = languages 
histogram BASIC 1-3 
plotting (CHHIST) 3-29 COBOL/400 1-5 
risers (CHSET) 3-75 DDS 1-32 
HLEFT option 3-72 how to use with OS/400 Graphics 1-2 
horizontal bar charts 3-76 Pascal 1-9 
HRIGHT option 3-72 PL/I 1-7 


HTOP option 3-72 RPG/400 1-18 
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last error, query (FSQERR) 2-40 
left and right margins (CHVMAR) 3-89 
legend 
base position (CHKEYP) 3-36 
blanking 3-68 
box 3-72 
columns/rows, order of keys 3-73 
construction 3-73 
key labels (CHKEY) 3-34 
legend text attributes (CHKATT) 3-32 
maximum legend width/height (CHKMAX) 3-37 
offsets (CHKOFF) 3-39 
rows/columns, order of keys 3-73 
unexpected positioning 3-34 
width/height (CHKMAX) 3-37 
LEGEND option 3-73 
LETTER option 3-67 
line 
draw a line (GSLINE) 2-91 
draw series of (GSPLNE) 2-107 
GDF order B-20 
relative GDF order B-21 
line break control character 3-35 
line graph 
CHPLOT 3-62 
lines on 3-73 
markers on 3-73 
line type 
GDF order B-21 
query current (GSQLT) 2-126 
set current (GSLT) 2-95 
table (CHLT) 3-42 
line width 
GDF order B-22 
GSFLW (set fractional line width) 2-79 


GSQFLW (query current fractional line width) 2-125 


line width table (CHLW) 3-43 
query current, GSQLW 2-127 
set current (GSLW) 2-96 
line-type numbers C-2 
LINEAR option 3-103 
lines on aline graph 3-73 
LINES option 3-73 
list of GDF orders B-2 


load graphics symbol set from auxiliary storage 


(GSLSS) 2-92 
loading DBCS symbol sets D-4 


logarithmic axis ranges (CHXRNG, CHYRNG) 3-98 


LOGARITHMIC option 3-103 
LOWAXIS option 3-103 


margins, chart 
CHHMAR (bottom and top) 3-31 
CHVMAR (left and right) 3-89 


marker GDF order B-22 
marker numbers C-2 
marker scale 
GSMSC (set marker scale) 2-103 
GSQMSC (query scale) 2-131 
marker symbol 
GSMRKS (draw series of) 2-101 
GSMS (set current) 2-102 
query current (GSQMS) 2-130 
marker table (CHMARK) 3-44 
marker type GDF order B-23 
markers on line graph 3-73 
MARKERS option 3-73 
maximum legend width/height (CHKMAX) 3-37 
MBAR option 3-74 
MIDDLE option 3-103 
missing data values 3-7 
mix GDF order B-16 
mixed double-byte data input D-5 
mixed-string attribute 
query (GSQSEN) 2-135 
mixing mode, color 
query (GSQMIX) 2-129 
set current (GSMIX) 2-98 
mode 
GDF order B-13 
GSCM (set current character) 2-66 
GSMIX (set current color-mixing) 2-98 
GSQMIX (query current color-mixing) 2-129 
month labels 
(CHXMTH, CHYMTH) 3-97 
abbreviations 3-67 
move without drawing (GSMOVE) 2-100 


N 


naming DBCS symbol sets D-4 
NBKEY option 3-68 
NBLABEL option 3-68 
NBNOTE option 3-68 
NBOX option 3-74 
NBVALUES option 3-68 
NCBOX option 3-68 
NDRAW option 3-72 
new-line character 
hex 15 in GSCHAP and GSCHAR_ 2-60 
semicolon in CHNOTE 3-50 
NKBOX option 3-73 
NOAXIS option 
CHYSET 3-102 
NOCURVE option 3-69 
NOFILL option 3-71 
NOFORCEZERO option 3-102 
NOGRID option 
CHYSET 3-102 


Index 


NOHEADING option 3-72 

NOLAB option 3-103 

NOLEGEND option 3-73 

NOLINES option 3-73 

NOMARKERS option 3-73 

non-bracketed double-byte data input D-5 

NONBOX option 3-74 

NOPROPIE option 3-75 

NORISERS option 3-75 

NOSKIPMONTH option 3-105 

notes 
blanking areas 3-68 
CHNATT (specify attributes) 3-45 
CHNOFF (specify offsets for CHNOTE) 3-47 
CHNOTE (specify note) 3-48 

NOVALUES option 3-71 

NTICK option 
CHYSET 3-103 

numeric data values, conventions for displaying 
CHSET 3-74 

NUMERIC option 3-105 


O 

offsets for CHNOTE (CHNOFF) 3-47 
offsets for legends 3-39 

open device (DSOPEN) 2-7 

order of keys in legend 3-73 
orientation, axis 3-76 

output (FSFRCE) 2-30 

output/input, device (ASREAD) 2-4 


P 
page 
clear current (FSPCLR) 2-32 
create (FSPCRT) 2-33 
delete (FSPDEL) 2-35 
query (FSPQRY) 2-36 
query current (FSQCPG) 2-38 
select (FSPSEL) 2-37 
page-id, query unique (FSQUPG) 2-41 
paper size, plotter 2-15 
Pascal, graphics considerations 1-9 
pattern 
GDF order B-23 
GSPAT (set current shading pattern) 2-104 
GSQPAT (query current shading pattern) 2-133 


pens 
speed 2-14 
velocity 2-14 


widths for area fill 2-14 
PERPIE option 3-74 
PGF (Presentation Graphics Facility) A-1 
picture space 

define (GSPS) 2-108 
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picture space (continued) 
query (GSQPS) 2-134 
pie chart 
area relationship between pies 3-75 
CHNUM (set number of components) 3-54 
CHPCTL (control pie chart slices) 3-56 
CHPIE 3-59 
CHPIER (pie reduction) 3-61 
data type 3-74 
exploded slices (CHPEXP) 3-57 
label configuration 3-75 
sector labels 3-34 
spider appearance 3-75 
pie reduction (CHPIER) 3-61 
PIEKEY option 3-75 
PL/I, graphics considerations 1-7 
placing bar-chart values 3-76 
PLAIN option 
CHYSET 3-104 
plotter color numbers C-1 
plotter line-type numbers C-2 
plotter marker numbers C-2 
plotter paper size 2-15 
plotter shading pattern numbers C-3 
plotters 1-1 
plotting 
bar charts 
CHBAR_ 3-12 
CHGAP (spacing between bars) 3-22 
CHGGAP (spacing between bar groups) 3-25 
CHVATT (value text attributes) 3-84 


CHVCHR (number of bar value characters) 3-86 


histograms (CHHIST) 3-29 
line graphs and scatter plots (CHPLOT) 3-62 
pie charts 
CHNUM (set number of components) 3-54 
CHPCTL (controlling slices) 3-56 
CHPEXP (exploded slices) 3-57 
CHPIE 3-59 
CHPIER (pie reduction) 3-61 
CHVATT (value text attributes) 3-84 
sector labels 3-34 
surface charts (CHSURF) 3-79 
Venn diagrams (CHVENN) 3-87 
position codes 1 and 2 3-48 
Presentation Graphics and GDDM, system 
requirements for use of 1-2 
Presentation Graphics routines 
compatibility with GDDM-PGF A-1 
primary and secondary axes, selection 
(CHXSEL, CHYSEL) 3-100 
printer color numbers C-1 
printer file (QPGDDM) 2-17 
printer line-type numbers C-2 
printer marker numbers C-2 


printer shading pattern numbers C-3 
printer, graphics-capable 1-2 
printers 1-1 
processing state, reset to state (CHSTRT) 3-78 
PROPIE option 3-75 
PTICK option 
CHYSET 3-104 
punctuation, numeric values (CHSET) 3-74 


Q 


QGDDM (IBM-supplied library) 1-2 
QPGDDM (printer file) 2-17 
query clipping mode (GSQCLP) 2-117 
query color table definition (GSQCTD) 2-123 
query current 
character angle (GSQCA) 2-112 
character box size (GSQCB) 2-113 
character direction (GSQCD) 2-114 
character mode (GSQCM) 2-118 
character shear (GSQCH) 2-116 
color (GSQCOL) 2-119 
color table (GSQCT) 2-122 
color-mixing mode (GSQMIX) 2-129 
fractional line width (GSQFLW) 2-125 
hardware cell size (GSQCEL) 2-115 
line type (GSQLT) 2-126 
line width (GSQLW) 2-127 
marker scale (GSQMSC) 2-131 
marker symbol (GSQMS) 2-130 
page-id (FSQCPG) 2-38 
position (GSQCP) 2-120 
shading pattern (GSQPAT) 2-133 
symbol-set identifier (GSQCS) 2-121 
viewport definition (GSQVIE) 2-139 
window definition (GSQWIN) 2-140 
query cursor position (GSQCUR) 2-124 
query device characteristics 
DSQDEV 2-20 
query device characteristics (DSQDEV) 2-20 
query device usage (DSQUSE) 2-24 
query last error (FSQERR) 2-40 
query loaded symbol sets (GSQSS) 2-136 
query mixed string attribute of graphic text 
(GSQSEN) 2-135 
query number of loaded symbol sets 
(GSQNSS) 2-132 
query number of segments (GSQMAX) 2-128 
query picture space definition (GSQPS) 2-134 
query specified page (FSPQRY) 2-36 
query text box (GSQTB) 2-137 
query unique device-id (DSQUID) 2-23 
query unique page-id (FSQUPG) 2-41 
querying symbol sets 
GSQNSS (query number of loaded symbol 
sets) 2-132 


querying symbol sets (continued) 
GSQSS (query loaded symbol sets) 2-136 


R 
range, explicit (CHXRNG, CHYRNG) 3-98 
RCP (request control parameter) codes 
description A-16 
list of codes for GDDM_  A-16 
list of codes for Presentation Graphics 
routines A-18 
reinitialize device (DSRNIT) 2-25 
reinitialize graphics 
GDDM, FSRNIT 2-43 
reinitialize Presentation Graphics routines 
(CHRNIT) 3-64 
related printed information H-1 
relative data 3-67 
RELATIVE option 3-67 
releasing DBCS symbol sets D-4 
releasing graphics symbol set (GSRSS) 2-141 
request control parameter (RCP) codes 
list of codes for GDDM A-16 
list of codes for Presentation Graphics 
routines A-18 
Request control parameter codes A-16 
reset processing state to state 1(CHSTRT) 3-78 
retransmit data (FSREST) 2-42 
retrieve graphics data 
(GSGET) 2-80 
GSGETE (end) 2-83 
GSGETS (start) 2-84 
RISERS option 3-75 
risers, histogram 3-75 
RPG/400, graphics considerations 1-18 


S 


scale 
factor (CHXSCL, CHYSCL) 3-99 
mark interval (CHXTIC, CHYTIC) 3-106 
scale-mark style 
y axis (CHYSET) 3-103 
scaled graphics image, draw (GSIMGS) 2-89 
scatier plots, plotting (CHPLOT) 3-62 
secondary axis, selection (CHXSEL, 
CHYSEL) 3-100 
segment 
attribute GDF order B-24 
close GDF order B-25 
GDF orders B-24 
GSQMAX (query number of segments) 2-128 
GSSCLS (close current segment) 2-142 
GSSDEL (delete) 2-143 
GSSEG (create) 2-144 
start GDF order B-24 
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select color table (GSCT) 2-70 
select page (FSPSEL) 2-37 
selection, axis (CHXSEL, CHYSEL) 3-100 
semicolon 
in CHKEY 3-35 
in CHNOTE 3-50 
set chart options (CHSET) 3-65 
set current 
character angle (GSCA) 2-50 
character direction (GSCD) 2-55 
character mode (GSCM) 2-66 
character shear (GSCH) 2-57 
character-box size (GSCB) 2-52 
color (GSCOL) 2-68 
color-mixing mode (GSMIX) 2-98 
line type (GSLT) 2-95 
line width (GSLW) 2-96 
marker symbol (GSMS) 2-102 
shading pattern (GSPAT) 2-104 
symbol set (GSCS) 2-69 
set fractional line width (GSFLW) 2-79 
set framing box attributes (CHBATT) 3-14 
set marker scale (GSMSC) 2-103 
set mixed string attribute of graphic text 
(GSSEN) 2-145 
set number of components (CHNUM) 3-54 
set string attribute 
set (GSSEN) 2-145 
set tag, GDF order B-25 
shaded area 
end (GSENDA) 2-76 
start (GSAREA) 2-47 
shading 
CHPAT 3-55 
method for Presentation Graphics routines 3-71 
shading pattern 
query current (GSQPAT) 2-133 
set current (GSPAT) 2-104 
shading pattern numbers C-3 
shear 
GDF order B-15 
GSCH (set current character shear) 2-57 
GSQCH (query) 2-116 
shift-control character 
size D-3 
shift-control characters 
description D-2 
size 
GSCB (set character box) 2-52 
GSQCB (query character box) 2-113 
GSQCEL (query hardware cell size) 2-115 
SKIPMONTH option 3-105 
software requirements 
5555-G01_ D-6 
5555-G02 D-6 
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sound device alarm (FSALRM) 2-27 
space, define picture (GSPS) 2-108 
spacing 
between bar groups (CHGGAP) 3-25 
between bars (CHGAP) 3-22 
spacing/size 
CHCGRD (basic character) 3-16 
special characters 
semicolon, in CHKEY 3-35 
semicolon, in CHNOTE 3-50 
underscore, in CHKEY 3-35 
special values, in CHKEY 3-35 
specify 
axis option (CHYSET, CHXSET) 3-101 
control of axis drawing (CHDRAX) 3-20 
device usage (DSUSE) 2-26 
error exit (FSEXIT) 2-28 
note attributes (CHNATT) 3-45 
offsets for CHNOTE (CHNOFF) 3-47 
translated axis lines or datum lines (CHXDTM, 
CHYDTM) 3-91 
specify intercept (CHXINT, CHYINT) 3-93 
specifying chart options 3-65 
spider appearance, pie chart 3-75 
SPIDER option 3-75 
SPILABEL option 3-76 
SPISECTOR option 3-75 
SPISLICE option 3-75 
start a shaded area (GSAREA) 2-47 
start retrieval of graphics data (GSGETS) 2-84 
state 1 and state 2 3-4, 3-8 
state 1, returning to 
with reinitializing Presentation Graphics routines 
(CHRNIT) 3-64 
without reinitializing Presentation Graphics routines 
(CHSTRT) 3-78 
summaries 
data types for GDDM 2-149 
data types for Presentation Graphics routines 3-110 
support 
double-byte character set D-1 
surface chart 
MOUNTAIN, NOMOUNTAIN options 3-74 
surface charts, plotting (CHSURF) 3-79 
symbol 
GSMARK (draw marker symbol) 2-97 
GSMS (set current marker symbol) 2-102 
GSQMS (query current marker symbol) 2-130 
symbol set A-19 
query current identifier (GSQCS) 2-121 
query loaded (GSQSS) 2-136 
set current (GSCS) 2-69 
set, symbols A-19 
symbol sets 
loading DBCS D-4 
releasing DBCS D-4 


symbol sets supplied with OS/400 Graphics 2-92 
syntax rules 
forGDDM 2-3 
for Presentation Graphics routine descriptions 3-8 
system requirements for using Presentation 
Graphics routines and GDDM_ 1-2 


T 


tag set, GDF order B-25 
terminate graphics (FSTERM) 2-44 
terminate Presentation Graphics routines 
(CHTERM) 3-83 
text 
attributes 
axis label (CHLATT) 3-40 
axis title (CHTATT) 3-81 
bar and pie chart values (CHVATT) 3-84 
CHXLAT, CHYLAT 3-95 
heading (CHHATT) 3-26 
legend (CHKATT) 3-32 
specification, axis title (CHXTTL, CHYTTL) 
text box 
GSQTB (query text box) 
tokens, device 2-7 
translated axis lines 
CHXDTM, CHYDTM (specify) 3-91 


U 


underscore, in CHKEY 3-35 
update display (FSFRCE) 2-30 
usage 
query device (DSQUSE) 2-24 
specify device (DSUSE) 2-26 


V 


value text attributes (CHVATT) 3-84 
VALUES option 3-69, 3-76 
vectors (GSVECM) 2-146 
Venn diagram 
CHVENN 3-87 
sector labels 3-34 
viewport 
define viewport (GSVIEW) 2-147 
query current definition (GSQVIE) 
VINSIDE option 3-76 
VONTOP option 3-76 


W 


ward D-2 

width 
GSLW (set current line width) 2-96 
GSQLW (query current line width) 


3-108 


2-137 


2-139 


2-127 


window 
define (GSWIN) 2-148 
query (GSQWIN) 2-140 
world coordinates, define (GSWIN) 


X 


x axis label attributes (CHXLAT) 3-95 
XTICK option 

CHYSET 3-104 
XVERTICAL option 3-76 


Y 


y axis label attributes (CHYLAT) 3-95 
YVERTICAL option 3-76 


Index 
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Overall, how would you rate this manual? 


Very 
Satisfied 
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Overall satisfaction 


How satisfied are you that the information in this manual is: 
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Easy to understand 


Well organized 
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